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MANUAL OBJECTIVES 

This manual summarizes the new software features for RSX-llM Version 
4.1, RSX-llS Version 4.1, and RMS-11 Version 2.0. It also includes 
information on problems and restrictions applicable to the new 
software and incompatibilities with the previous version. Therefore, 
it is important to read this document before generating and using your 
system. 



INTENDED AUDIENCE 

The RSX-llM/RMS-11/RSX-llS Release Notes are intended for all users of 
the RSX-llM or RSX-llS operating systems. 

STRUCTURE OF THE DOCUMENT 

CHAPTER 1 RSX-llM VERSION 4.1 RELEASE NOTES 

Section 1.1 New Features RSX-llM V4.1 

Describes briefly the major new features of RSX-llM 
V4.1 

Section 1.2 Summary of Technical Changes 

Provides brief summaries of the new software features 
and refers you to the appropriate manuals in the 
documentation set for complete information. Any 
changes made to the documentation since V4.0 including 
new, revised, or updated manuals, are also indicated. 

Section 1.3 Notes on Software 

Describes the incompatibilities between the previous 

and the new versions of RSX-llM, and provides 

additional miscellaneous information pertinent to the 
successful performance of the software. 

Section 1.4 Reporting Problems and Errors 

Provides information on reporting any problems you 
encountered with the new software, and describes 
procedures for applying corrections to files on the 
source disk. 
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Section 1.5 Notes to RSX-llM V4,l Documentation 

Describes errors and omissions in the RSX-llM V4.1 
documentation and refers you to the appropriate places 
in the documentation to make corrections. 

CHAPTER 2 RMS-11 VERSION 2.0 RELEASE NOTES 

Section 2.1 New Features for RMS-11 Version 2.0 

Briefly describes the major new functionality for 
RMS-11 Version 2.0. 

Section 2.2 Summaries of Technical Changes 

Provides brief summaries of the new software features 
and refers you to the appropriate manuals in the 
documentation set for complete information. Changes 
made to the documentation since RMS-11 Version 1.8, 
including new and revised manuals, are also included. 

Section 2.3 Comparisons with RMS-11 Version 1.8 

Describes differences between Version 1.8 and Version 
2.0 of RMS-11, including new features and restrictions 
in the use of RMS-11. 

Section 2.4 Miscellaneous Information 

Contains general notes on new RMS-11 features and 
restrictions. 

Section 2.5 Problems Fixed with RMS-11 Version 2.0 

Lists problems reported for Version 1.8 that are fixed 
for Version 2.0. 

Section 2.6 Known Problems with RMS-11 Version 2.0 

Notes problems that may occur with the use of RMS-11. 

Section 2.7 RMS-11 Files and Placement on the Distribution Kit 

Lists the files contained in the RMS-11 Version 2.0 
distribution kit. 

Section 2.8 RMS-11 Version 2.0 Installation 

Provides information required to install RMS-11 and 
configure the RMS-11 utilities. 

Section 2.9 Reporting Problems and Errors 

Provides information on reporting any problems you 
encountered with the new software. 

CHAPTER 3 RSX-llS VERSION 4.1 RELEASE NOTES 

Section 3.1 New Features for RSX-llS V4.1 

Describes briefly the major new features of RSX-llS 
V4.1. 
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Section 3.2 Notes on Software 

Describes the incompatibilities between the previous 
and the new versions of RSX-llS, and provides 
additional miscellaneous information pertinent to the 
successful performance of the software. 

Section 3.3 Notes to the RSX-llS V4 .1 System Generation and 
Installation Guide 

Describes errors and omissions in the RSX-llS V4.1 
System Generation and Installation Guide and refers you 
to the appropriate places in the documentation to make 
corrections. 

Section 3.4 SYSGEN Dialogue from an RSX-llM Host 

Contains an example of an RSX-llS V4.1 SYSGEN on an 
RSX-llM V4.1 host system. 

Section 3.5 SYSGEN on an RSX-llM-PLUS Host 

Briefly describes how to perform an RSX-llS V4.i SYSGEN 
on an RSX-llM-PLUS host system. 

Section 3.6 SYSGEN on a VAX/VMS Host 

Briefly describes how to perform an RSX-llS V4.1 SYSGEN 
on a VAX/VMS host system. 
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CHAPTER 1 
RSX-llM V4.1 RELEASE NOTES 



1.1 NEW FEATURES FOR RSX-llM V4.1 

RSX-llM Version 4.1 software is an update of the disk-based RSX-llM 
operating system. The major new features for RSX-llM V4.1 include the 
following: 

• Software Performance Monitor support 

• Support for Micro/PDP-11 

• New device support 

• Multivolume backups for disks 

• RMS-11 Version 2.0 



1.1.1 RSX-llM Executive 

The following items are changes to the RSX-llM V4.1 Executive: 

• Some Executive routines have been moved out of the ERROR 
module and into an Executive Common. This change only affects 
systems with both error logging support and Executive Common 
support. See Section 1.3.8 for more information. 

• The Software Performance Monitor (SPM-llM) hooks are 
integrated into the RSX-llM V4.1 Executive. As a result, you 
do not need to perform another SYSGEN to install SPM-llM. 

• The RSX-llM V4.1 Executive no longer supports attaching a 
device with IQ.X functionality. 



1.1.2 SYSGEN Features 

The following SYSGEN features are new for V4.1: 

• RSX-llM SYSGEN must be done on a mapped host system. 

• To do a SYSGEN, you must have a host system with at least 54K 
words of memory. 

• A mapped target system is now the default target system. 

• A new question asks whether you want RT-11 emulation support. 
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• Devices with the mnemonic DU are now valid crash devices. As 
with all devices, crash support is restricted to 
removable-media devices. 

• A new question asks whether you want Software performance 
Monitor (SPM-llM) support. SPM-llM, which must be purchased 
separately, provides data on system usage. This question is 
always asked (even if you choose the Standard Function 
System) . If you answer yes, the SPM-11 hook points are 
included in the system. You can then install the separate 
SPM-llM layered product. 

• Micro/PDP-11 has been added to the list of supported 
processors. 

• RSX-llM V4.1 distribution kits are now in BRU format. 

• RSX-llM is no longer distributed on RK05s. 

• The stand-alone DSC system (DSC64K) and the stand-alone BAD 
system (BADSYS) have been removed from the distribution kits. 

• RSX-llM V4.1 SYSGEN now supports all the new devices listed in 
Section 1.2.5. 



1.1.3 Backup and Restore (BRU) 

BRU has three new features for RSX-llM V4.1: multi volume backups for 
disks, a new sort algorithm, and additional device support. See 
Section 1.2.4.1 for additional information. 



1.1.4 MCR and VMR 

RSX-llM now allows you to set the round-robin scheduling interval and 
priority using either MCR or VMR. 

RSX-llM now allows you to set the interval length and priority range 
for Executive swapping. See Section 1.2.2 (MCR) and Section 1.2.7.1 
(VMR) for more information. 

MCR supports ail the new devices listed in Section 1.2.5. 



1.1.5 Task Builder (TKB) 

The following is an abbreviated description of the functionality of 
the Task Builder for RSX-llM V4.1: 

• The Autoload entry point has been modified. This entry point 
is now accessed by an indirect reference through the Overlay 
Run-Time System's impure area rather th'an by direct references 
in the Autoload vector. 

• The Symbol Table File (.STB) now contains two forms of symbol 
definition. To maintain backward compatibility, all 
autoloadable symbols are entries in the global symbol 
directory and the vector itself is defined in associated text 
records. Additionally, a new internal symbol directory 
record, which is TKB-generated, supports selective inclusion 
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of autoloadable symbols for conventional tasks as well as the 
information needed to generate autoload vectors for I- and 
D-space tasks in RSX-llM-PLUS systems. 

• Autoload vectors supplied by the symbol table (.STB) files of 
resident libraries are now selectively included in the user's 
task image. Previously, all autoload vectors resulting from 
autoloadable symbols were present in the task image. Now, 
only referenced symbols result in autoload vectors that are 
present in the task image. 

• Libraries created with older versions of TKB do not have the 
ISD records in the .STB file that newer versions of TKB use to 
create autoload vectors. Therefore, TKB must include vectors 
from, the =STB file for every entry point in the library. 

• The rules concerning cluster libraries have changed so that 
the first library of the cluster, the default library, can now 
have a non-null root. 

• The following option is new in TKB: 

DSPPAT Allows object-level patching of a conventional task or 
the D-space part of an I- and D-space task. 

• The following switch is new in TKB: 

/EL Specifies the maximum possible size for the library 
according to the size specified in the PAR option. 
The switch specifies a larger library virtual address 
range than is actually present in the library to allow 
RMS to map its vectored library segments. 



1.1.6 New Device Support 

RSX-llM V4.1 supports a number of new devices. See Section 1.2.5 for 
a complete list. 



1.1.7 Support for the LA50, LAIOO, and LNOl Printers 

Support has been added to RSX-llM/M-PLUS for the LA50, LAIOO, and LNOl 
printers. These printers are capable of printing either 132 or 80 
columns on 8 1/2 inch wide paper. 

You can select support for these printers while performing SYSGEN. 
During SYSGEN, this support is a task-build option for the queue 
manager (QMG) and the line printer processor (LPP) , and it is the 
default. 

In order to use an LA50 , LAIOO, or LNOl printer, you set the printer 
type when you initialize the print processor by using a form type in 
the command line. The valid form types are as follows: 

Form types Printer type 

125. LA50 

126. LAIOO 

127. LNOl 
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For example, if you have a LA50 printer connected to terminal line 
TT6:, you use the following command to initialize the print processor. 

(MCR) QUE TT6:/SP/FO:125./FL:l/LOWER 

(DCL) INITIALIZE/PROCESSOR TT6 :/FORMS:125/FLAG :1 /LOWER 

When you wish to print a file, select your desired printer mode by 
including one of the following form types in the command line: 

Form types Printer mode 

3. 132-column, draft quality. Also 

landscape mode for LNOl. 

4. 80-column, letter quality. Also portrait 

mode for LNOl. 

5. 132-column, letter quality. Also 

landscape mode for LNOl. 

6. 80-column, draft quality. Also portrait 

mode for LNOl. 

For example, to print the 132-column draft quality TEST.LST file (that 
is, a normal listing file) and the 80-column letter quality TEST. TXT 
file on an LA50, use the following commands. Note that these commands 
assume that you have assigned the default print queue, PRINT, to the 
processor handling the LA50. 

(MCR) PRI /P0:3.=TEST.LST 
PRI /F0:4.=TEST.TXT 

(DCL) PRINT/FORM: 3 TEST.LST 
PRINT/FORM: 4 TEST. TXT 

Modifying or Removing Support for the Printers 

The printer options are controlled by task-build parameters in the 
build files for the queue manager and the line printer processor. 
These build files are, respectively, [1 ,20]QMGBLD.BLD and 
[1 ,20]LPPBLD.BLD on the distribution kits. You can modify these prior 
to building the queue manager and the line printer processor during 
SYSGEN. You can modify these files for the following reasons: 

1. You can change the form types that are used to represent 
printer types. To do so, modify the GBLDEP options that 
define the symbols Q$LSPS and Q$HSPS. The comments in the 
build files explain the values of the symbols. The normal 
defaults are 125. through 127. 

2. You can change the form types that are used to represent 
document types. To do so, modify the GBLDEF options that 
define the symbols Q$LSPF and Q$HSPF. The comments in the 
build files explain the value of the symbols. The normal 
defaults are 3. through 6. If you modify the range of form 
types, you must change the GBLPAT options that define the 
forms to include offsets appropriate for the new form types. 
(See the comments in the command file regarding form 
definition.) 

3. You can remove the support for. these printers altogether. 
This may be necessary if you do not have any of these 
printers and if you use form types in the range 3. through 
6. or 125. through 127. In order to remove the support, 
set the values of Q$LSPS and Q$LSPF to 1 and the values of 
Q$HSPF and Q$HSPS to 0. You may also wish to remove the four 
GBLPAT definitions for the form types 3. through 6. 
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Note to LAIOO Users 

If you have a LAIOO printer and you use 
it for standard 132-column, 14 1/2 inch 
paper, you probably will want to 
establish it as your standard printer 
— with form type — and not use this 
support. This support is intended 
primarily for applications including all 
three printers and involving 8 1/2 inch 
wide forms. 



1.1.8 Files-11 ACP 

Two new features have been added to Files-11 (FllACP) in RSX-llM V4.1 
to support RMS-11 V2.0: 

• FllACP supports new file attribute codes (creation, revision, 
expiration, and backup dates) , which read and write the data 
in the file header using a 64-bit date format. FllACP 
performs a computation to convert the date between 64-bit 
binary and ASCII form. 

• FllACP also supports the $SEARCH function of RMS-11 V2.0 by 
providing character wildcarding assistance. This support 
substantially reduces processing time when portions of a 
filename include wildcards. 

Because of these features, you cannot use RMS-11 V2.0 on a version of 
RSX-llM prior to V4.1. 



1.1.9 PDP-11 PASCAL/RSX 

RSX-llM V4.1 includes DCL support for PDP-11 PASCAL. Note however, 
that PDP-11 PASCAL is scheduled to be released at a date later than 
that of RSX-llM V4.1. Therefore, until PDP-11 PASCAL/RSX is available 
on your system, the use of the PASCAL command will result in the 
informational message "PASCAL — Sorry task not installed." 

RSX-llM V4.1 lists PASCAL as one of the available HELP topics. 
However, until PDP-11 PASCAL/RSX is released and becomes available on 
your system, typing "HELP PASCAL" will result in the message 
"PASCAL currently is unavailable on your system." PASCAL commands will 
be documented in the PASCAL User's Guide , distributed at the time of 
the PDP-11 PASCAL/RSX release. Complete HELP files for PDP-11 
PASCAL/RSX will be provided with the PASCAL distribution kit at the 
time of its release. 



1.2 SUMMARY OF TECHNICAL CHANGES 

The following sections list the new features for RSX-llM as described 
in your documentation. A summary of technical changes also appears in 
the preface of each manual. 

The title of each manual is followed by a letter indicating whether 
the manual is a NEW (N) , REVISED (R) , or UPDATED (U) version. 
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1.2.1 RSX-llM System Generation and Installation Guide (R) 

The following new options and features have been added to the RSX-llM 
system generation and installation procedure: 

• SYSGEM must be performed on a mapped host system with at least 
64K words of memory. 

• SYSGEN no longer supports the RK05 distribution kit. 

• SYSGEN now supports SPM-llM. 

• SYSGEN now supports RA60 removable media and RA81 fixed media 
under the UDA50 hardware controller. 

• SYSGEN now supports RC251 fixed/removable media. 

• SYSGEN now supports RD51 fixed media and RX50 floppy disk 
drives under the RQDXl hardware controller. 

• SYSGEN now supports TSV05 and TU80 magnetic tape drives under 
the TSll hardware controller. 

• SYSGEN now supports the LNOl, LP07, LP26, and LP27 line 
printers under the LPll hardware controller. 

• SYSGEN now supports the DHVll hardware controller. 

• The distribution kits now only contain a mapped baseline 
system. 

• The default for the target system configuration is now mapped. 

• SYSGEN will always install the V4.1 TKB from the distribution 
kit with the task name ...TKL. 

• SYSGEN now allows DU devices {RA60 , RC25 , and RX50 only) to be 
chosen as the crash dump device. 

• In an RLOl/02 PREPGEN, the EXCPRV disk is mounted by SYSGEN. 

• The RSX-llM magnetic tape distribution kits are now in BRU 
format. Also, BRU is now used to copy all the RSX-llM V4.i 
distribution kits. 

• RMS-11 V2.0 is now included in the RSX-llM V4.1 distribution 
kit. 



1.2.2 RSX-llM/M-PLUS MCR Operations Manual (U) 

The following are new MCR features for RSX-llM V4.1; 

• MCR commands now support the following new devices: RA60 , 
RA81, RC25, RX50, RD51, TSV05, and TUSO. 

• The following MCR SET keywords have been modified: 



1. There are a number of references in the RSX-llM/M-PLUS manuals, 
including these Release Notes , to the RC25 device. This device is, as 
of the first publication date of the manuals, not available for sale 
or distribution; nor is its mention in the documents a commitment by 
DIGITAL to sell or distribute this device. 
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- /RNDC - Defines the length of the Executive round-robin 
scheduling interval. 

- /RNDH - Defines the highest priority that will be 
considered for Executive round-robin scheduling. 

- /RNDL - Defines the lowest priority that will be considered 
for Executive round-robin scheduling. 

- /SWPC - Defines the length of a single Executive swapping 
interval. 

- /SWPR - Defines a new priority range for Executive 
swapping. 

The /REMOTE and /SPEED keywords now support new terminal 
speeds and speed combinations for the DHVll multiplexer. 
The new speeds are 75, 110, 134.5, 150, 300, 600, 1200, 
1800, 2000, 2400, 4800, 9600, and 19200. 

- The /TERM keyword now supports the LA50. For more 
information, see Section 1.5.1 of the 
RSX-llM/RMS-11/RSX-llS Release Notes . 

The following error message is new to the MCR REDIRECT 
command: 

TT redirect error 

This message means that an attempt was made to redirect a 
terminal (TTn:) to a null device. 



1.2.3 RSX-llM/M-PLUS Command Language Manual (R) 

This revision of the RSX-llM-PLUS Command Language Manual incorporates 
changes and additions listed in the following sections. 



1.2.3.1 COBOL-81 - The following lists the new features and 
modifications to DCL COBOL-81 commands: 

• COBOL-81, rather than COBOL-11, is now the default compiler. 

• COBOL-Cll invokes the current COBOL-11 compiler to perform the 
compilation. 

• COBOL [/C81] invokes the COBOL-81 compiler to perform the 
compilation. 

DCL command line for COBOL-81: 

C0B0L[/C81] [/qualifier[s] filespec [/qualifier [s] ] 

The DCL qualifiers and their MCR translation follow. A (D) indicates 
the default. 

DCL Qualifier MCR Syntax 

/OBJECT [=file] (D) COBOL file, [ list] , [diag]=source 

/NOOBJECT COBOL , [ list] , [diag] =source 

Specifies whether an object file is created. 
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/LIST[=file] COBOL [obj] ,f ile, [diag] =source 

/NOLIST (D) COBOL [obj ],, [diag] =source 

Specifies whether a compile listing is created. 

/DIAGNOSTICS [=f ile] COBOL [obj] ,[ list] ,file=source 

/NODIAGNOSTICS (D) COBOL [ obj] ,[ list] =source 

Specifies whether a diagnostics file is created. 

/OVERLAY_DESCRIPTION /BLD 

/NOOVERLAY_DESCRIPTION (D) /-BLD 

Specifies whether an indirect command file (.CMD) and an 
Overlay Descriptor Language (.ODL) file are produced. If you 
use the LINK/C81 command to task-build a program, do not use 
this qualifier. LINK/C81 also produces a .CMD and an .ODL 
file. 



/CODE:CIS /CIS 

/CODE:NOCIS (D) /-CIS 

Specifies whether the compiler should use CIS instructions in 
the object code it produces. 

/CROSS_REFERENCE /CRF 

/NOCROSS_REFERENCE (D) /-CRF 

Specifies whether cross-reference tables should be appended to 
the compile listing. 

/ANSI_FORMAT /CVF 

/NOANSI_FORMAT (D) /-CVF 

Indicates whether the source program is in conventional ANSI 
format or DIGITAL'S terminal format. 

/DEBUG /DEB 

/NODEB'JG (D) /-DEB 

Specifies whether the symbolic debugger is used. If this 
qualifier is used, the LINK/C81/DEBUG command must also be used 
to link the file. 

/SHOW /MAP 

/SHOW: MAP /MAP 

/SHOW:NOMAP (D) /-MAP 

/NOSHOW /-MAP 

Indicates whether the Data Division and Procedure Division 
offset maps are to be included in the list file, 

/TRUNCATE /TRU 

/NOTRUNCATE (D) /-TRU 

Indicates whether the compiler is to perform decimal truncation 
on the values of COMP data items. 
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/CHECK /PER/BOU 

/NOCHECK (D) /-PER/-BOU 

/CHECK :ALL /PER/BOU 

/CHECK: NONE /-PER/-BOU 

/CHECK: BOUNDS /BOU 

/CHECK :NOBOUNDS /-BOU 

/CHECK: PERFORM /PER 

/CHECK iNOPERFORM /-PER 

Deals with run-time error checking. /CHECK enables subscript 
(index) range checking and nested PERFORM checking. /NOCHECK 
suppresses both of these. /CHECK :NOPERFORM and /CHECK :NOBOUNDS 
suppress each check individually. 

/NAMES :aa /KER:aa 

Tells the compiler to use the two alphanumeric characters 
specified as the PSECT kernel for this program. 

/WARNINGS (D) /INF 

/NOWARNINGS /-INF 

/WARNINGS : INFORMATIONAL /INF 

/WARNINGS :NOINFORMATIONAL /-INF 

Specifies whether the compiler should issue informational 
diagnostics during the compilation. 

/SKELETON (D) <no translation> 

/NOSKELETON /-SKL 

Specifies whether a skeleton Overlay Description Language 
(.SKL) file is created. 

/SUBPROGRAM /SUB 

/NOSUBPROGRAM (D) <no translation> 

Indicates whether this program is a subprogram. 

/TEMPORARY: device /TMP: device 

Tells the compiler to store its temporary work files on the 
specified device. 



1.2.3.2 LINK/C81 Conmand - The LINK/C81 command links COBOL-81 object 
files to produce a task image. The command will not work with 
versions of COBOL-81 prior to V4.0. 

DCL LINK/C81 command line: 

LINK/C81 [/qualifier (s)] [filespec( ,s)] 

LINK/COBOL[/qualif ier(s)] [f ilespec( ,s) ] 
The new DCL qualifiers for this command follow. 
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/[NO]FMS 
/FMS:NORESIDENT 

The /FMS qualifier causes LINK/C81 to include Forms Management 
Services (FMS) library support in your task image. You must use 
this qualifier if you call FMS routines in your program. /NOFMS 
tells LINK/81 not to include FMS support. This is the default. 

The /FMS:NORESIDENT qualifier causes LINK/C81 to include support 
for a non-memory- resident FMS library in your task image. 

/OTS: [NO] RESIDENT 

The /OTS:RESIDENT qualifier includes memory-resident OTS in your 
task image. 

/RMS: [NO] RESIDENT 
/NORMS :NORESIDENT 

The /RMSsRESIDENT qualifier creates a reference to the shared 
RMS-11 memory-resident library, RMSRES. This library includes 
input and output support for sequential, indexed, and relative 
file organizations. 

/[NO] MAP 

The /MAP qualifier causes LINK/C81 to produce a Task Builder map 
file with the file type .MAP. /NOMAP is the default. 



/[NO] DEBUG 



The /DEBUG qualifier tells LINK/C81 to include the COBOL-81 
Symbolic Debugger in your task image. You must have assembled 
the object module with the /DEBUG switch. /NODEBUG is the 
default. You must have assembled the object module with the 
/DEBUG switch. 



1.2.3.3 CORAL 66 - RSX-llM systems support CORAL 66, a high-level 
block-structured programming language. Following is the format and 
descriptions of the qualifiers available with CORAL 66. 

Format: 

CORAL [/qualifier] filespec[s] 
Command qualifiers: 

/[NO] CHECK 

The /CHECK qualifier specifies that the code generated will 
check that all subscripts used in array and switch 
references are within bounds. The /NOCHECK qualifier is the 
default. 

/CODE:arg 
EIS 
FIS 
FPP 
PIC 

The /CODE qualifier allows you to choose (at compile time) 
the instruction set for which the code is to be generated 
regardless of which machine is used to compile the source 
program. 
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/ [NO] EXTEND_SOURCE 

The /NOEXTEND_SOURCE qualifier causes the compiler to 
"rocsss the first 72 characters of source inout per line- 
The default is the /EXTEND_SOURCE which causes all 
characters in an input line to be processed. 

/[NO] LIST 

The /LIST qualifier allows you to specify whether a compiler 
listing should be generated. The default is the /NOLIST 
qualifier which causes no compiler listing to be generated. 

/[NO]MACHINE_CODE 

The /MACHINE_CODE qualifier specifies that you want the 
compiler listing to include a representation of the machine 
code generated. The default is the /NOMACHINE_CODE 
qualifier. 

/NAMES :X 

The /NAMES qualifier causes the first character of 
compiler-generated program-section names to be the character 
•x', in order to make them unique for this compilation. 

/ [NO] OBJECT [ : f i lespec] 

The /OBJECT qualifier allows you to specify whether or not 
the compiler must generate an object module. The default is 
the /OBJECT qualifier, which generates an object file. 

/[NO] OPTIMIZE [ [:LEVEL] :n] 
/OPTIMIZE=n 

The /OPTIMIZE qualifier allows you to optimize the function 
of CORAL 66 source programs. 

/READ_ONLY[:arg] 
ALL 
NONE 
PURE_DATA 

The /READ_ONLY qualifier allows you to alter the READ-ONLY 
or READ-WRITE attributes of program sections. 

/[NO]SHOW[:arg[,s]] 
ALL 

EXPANSION 
NONE 

OVERRIDE 
SOURCE 
STATISTICS 
SYMBOLS 

The /SHOW and /NOSHOW qualifiers specify elements you want 
included in or excluded from the listing file. 

/[NO] STANDARD 

The /STANDARD qualifier highlights non-IECCA keywords in the 
listing as warning messages. The default is the /NOSTANDARD 
qualifier, which suppresses this function. 
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/TEST[:n] 

The /TEST qualifier allows you to retain or omit 
declarations and statements from a particular compilation 
without editing the source text. 

/[NO]TRACEBACK 

The /TRACEBACK qualifier generates additional code to print 

source-file and line-number information in run-time error 

messages. The /NOTRACEBACK qualifier suppresses this 
function and is the default. 

/WIDTH :n 

The /WIDTH:n qualifier allows you to set the listing file to 
a specific width in the decimal range 8 through 132. The 
/WIDTH: 132 qualifier is the default. 



1.2.3.4 BASIC-PLUS-2 - BASIC-PLUS-2 is now the default BASIC 
compiler. The compiler can create Task Builder Command and Overlay 
Descriptor Language files and a listing file in addition to the object 
module file for the program it compiles. (Note that BASIC/Bll runs 
BASIC-11.) 



1.2.3.5 PORTRAN-77 - FORTRAN IV-PLUS has been superseded by 
FORTRAN-77, although both compilers are supported by DCL (as well as 
FORTRAN-IV) . Qualifiers added for FORTRAN-77 are as follows: 

/[NO] STANDARD: a rg 
ALL 
NONE 
SOURCE 
SYNTAX 

Directs the compiler to look in your source code for extensions 
to ANSI standard FORTRAN at the full language level. 



1.2.3.6 BACKUP Comnand - Two new qualifiers have been added to the 
BACKUP command and several qualifiers have new functions because of 
multivolume disk backup and restore operations. They are as follows: 

• /APPEND 

Appends new data to a tape or disk that already has one or 
more backup sets. 

• /DIRECTORY 

Directs BACKUP to create UFDs (if they do not already exist) 
on a mounted output volume, then copy into the UFDs the files 
from the same UFD on the input volume. 

• /IMAGE: a rg 

SAVE 
RESTORE 

Specifies that you want to do a multivolume disk-to-disk 
backup or restore operation. 
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/SAVE_SET 

Specifies the name of the backup set to be placed on tape or 
disk. For tapes and unmounted disks, the default name is the 
volume name for the disk being backed up. For mounted input 
or output disks during an image backup or restore operation, 
you can specify the full backup set name with SAVE_SET. 



1.2.3.7 SHOW Processortype Command - The DCL SHOW processortype 
command line has been modified so that you issue the command line as 
follows: 

SHOW processortype processorname[/qualif ier] 
BATCH 

CARDREADER 
DEVICE 
INPUT 
PRINTER 
PROCESSOR 

The SHOW processortype command displays information about processors, 
card readers, batch processors, and other devices under the control of 
the Queue Manager. 

CARDREADER and INPUT are synonyns. DEVICE refers to all nonbatch 
output processors and is a synonym for PRINTER. BATCH refers to all 
batch processors. (Batch processing is available only on 
RSX-llM-PLUS.) 

A simple SHOW PROCESSOR command displays all processors in the system. 



1.2.3.8 Miscellaneous Items - The following lists various 
modifications to DCL for RSX-llM V4.1: 

• EDT is now the default editor. 

• The following qualifiers have been modified: 

- /CHECKPOINT_FILE and /WIDTH 

These qualifiers when used with SET DEVICE now accept 
decimal numbers by default. 

• The /HFILL and /VFILL qualifiers for the SET TERMINAL and SHOW 
TERMINAL commands have been eliminated. However, the existing 
/CRFILL and /LFFILL qualifiers perform the same functions, 
respectively, as the two removed qualifiers. 

• The INITIALIZE/QUEUE command has a new qualifier, /NOWARNINGS. 
This qualifier inhibits error messages. 



1.2.4 RSX-llM/M-PLUS Otilities Manual (0) 

Following are the additions and changes for the Backup and Restore 
Utility (BRU) and the Task/Image Patch Program (ZAP) . 
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1.2.4.1 Backup and Restore Utility (BRU) (R) - BRU for RSX-llM V4.1 
has three new features: 

• BRU now does multivolume backups. You can copy a single disk 
onto multiple smaller disks. However, when you do this, the 
smaller disks are in BRU format, not Files-11. This means 
that before you can read what is on the smaller disk, you must 
restore it with BRU. This process is similar to magnetic tape 
backup and restore operations. 

To backup and restore a single disk to multiple disks, you 
use the following new BRU switch: 

BRU /IMAGE: SAVE 

: RESTORE 

Specifies that you want to do a multiple disk-to-disk 
backup or restore operation. If you are doing a backup 
operation, you must specify the SAVE option on the command 
line. If you are doing a restore operation, you must 
specify the RESTORE option on the command line. 

Because of the addition of multivolume disk backups, the 
meanings of the following BRU qualifiers have changed. 

- /APPEND 

Directs BRU to append a backup set from the input disk 
volume to the last backup set on the output tape, or on the 
output disk if you are using the /IMAGE qualifier. 

- /BACKUP_SET:name 

Specifies the name of the backup set to be placed on tape 
or disk. For a mounted input or output disk during an 
image backup or restore operation, you can specify the full 
backup set file name with the /BACKUP_SET qualifier. 

- /DIRECTORY 

Lists at your terminal the backup set names or files on the 
specified tape or disk volume. 

- /INITIALIZE 

Specifies that you want to initialize the output disk 
during a tape-to-disk or disk-to-disk operation. 

- /INVOLUME 

Specifies the volume label of the input disk. 

- /MOUNTED 

Allows you to back up files from a disk that is mounted as 
a Files-11 volume. 

- /NEW_VERSION 

Resolves file specification conflicts that occur during 
either backup or restore operations to a mounted disk. 
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- /SUPERSEDE 

Specifies that when file specifications on the mounted 
output volume are identical to the file specifications on 
the input volume, the file on the output volume is deleted 
and replaced with the file from the input volume. 

• BRU has a new sort algorithm, which increases the speed of the 
sorting procedure. 

• In Version 4.1, if you use the /MOUNTED qualifier when the 
input device is a tape, BRU issues a syntax error message. 
The purpose of this error message is to clarify to the user 
that tapes cannot be mounted as Files-11 volumes. Previously, 
BRU ignored this qualifier if the user issued it for a tape 
input device. 

• New examples have been added to BRU. They are as follows: 

Disk-to-disk multivolume backup operations, 

- Disk-to-disk multivolume restore operations. 

- Disk-to-disk multivolume backup and append operation. 

Disk-to-disk multivolume restore operation for restoring an 
appended backup set. 

• New error messages for multivolume backup and restore 
operations have been added to the BRU chapter. 

• BRU now supports the following additional devices: 
Mnemonic Type 

MS TSV05/TU80 magnetic tape 

EM MLll electronic memory 

DU RA60/RA81/RC25/RD51/RX50 disk 

• Changes have been added to bootstrapping stand-alone BRU for 
RSX-llM. 

On RSX-llM, you can now find BRU64K.SYS and BRU64K.STB in UFD 
[1,51] on the following disk volumes: 

BIG DISK KIT - RSXM35 

RK06/RK07 KIT - CLISRC 

RL01/RL02 KIT - RLUTIL 



1.2.4.2 Task/File Patch Program (ZAP) - A new section has been added 
to Chapter 15 (ZAP) describing the use of the /LI qualifier with I- 
and D-space tasks and a new description of the /LI switch and 
Multiuser Task Image files has been added. 
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1.2.5 RSX-llM/M-PLUS I/O Drivers Reference Manual (R) 

The following new devices are supported by RSX-llM V4.1. 

Supported terminal devices: 

Type Mnemonic 

LQP02 letter quality printer TT 

LA50 personal printer TT 

DHVll multiplexer YH 

Supported disks: 

Type Mnemonic 

RA81 fixed media disk DU 

RA60 removable media disk DU 

RC25 fixed media/removable cartridge disk DU 

RD51 fixed media disk DU 

RX50 floppy disk DU 



Supported magnetic tapes: 
Type 
TU80 magnetic tape 
TSV05 magnetic tape 



Mnemonic 

MS 
MS 



Supported line printers: 
Type 
LNOl line printer 
LP07 line printer 
LP26 line printer 
LP27 line printer 



Mnemonic 

LP 
LP 
LP 
LP 



1.2.6 RSX-llM/M-PLUS Task Builder Manual (R) 

Following are the major changes documented in the Task Builder manual; 
• New Switch 



/EL 



Extend Library 



This switch specifies the maximum possible size for the 
library according to the size specified in the PAR option. 
The switch specifies a larger library virtual address range 
than is actually present in the library to allow RMS to map 
its vectored library segments. 



1-16 



RSX-llM V4.1 RELEASE NOTES 

• New Options 

- DSPPAT — Allows object-level patching of a conventional 
task or the D-space part of an I- and D-space task. 

• Changed Options 

- ABSPAT — Allows object-level patching of a conventional 
task or the l-space part of an I- and D-space task. 

• New Error Messages 

Module module-name contains incompatible autoload vectors 

• Changed Error Messages 

Original: Lookup failure resident library file 

Revised: Lookup failure resident library file - 
filename. ext 

• Miscellaneous Technical Changes 

- Autoload vectors for conventional tasks have changed. The 
call to $AUTO is now made indirectly through .NAUTO in the 
overlay impure area. 

- You now can write an .ODL specification by applying certain 
rules to the virtual address space diagram. 

- The overlay run- time system routines have changed size from 
the previous release. 

- For versions of TKB that support I- and D-space tasks and 
that were used to build libraries, TKB allocates autoload 
vectors in the root of the task only for those autoloadable 
entry points in the library referenced by the task. 

- Internal Symbol Directory Records, along with their 
formats, are described in Appendix A of the RSX-llM/M-PLUS 
Task Builder Manual . They consist of: 

• Type 1 records, generated by TKB and output to the .STB 
file 

• Type 2 records, generated by language processors 

• Type 3 records, created from type 2 records and output 
to the .STB file. 

• Type 4 records, written to the .STB file without 
modification. 

- A new bit called LD$TYP distinguishes between a library or 
common. It is at the offset R$LFLG in the resident library 
name block data in Appendix B of the manual. 

The first library in a cluster may be overlaid and contain 
a no n- null root. 

- New Task Builder reserved symbols have been added to 
Appendix E. 



1-17 



RSX-llM V4.1 RELEASE NOTES 



The Fast Task Builder supports the /EA switch and the TASK= 
option. 

Other, minor technical and editorial changes have been 
made. 



1.2.7 RSX-1114/M-PLUS System Management Guide (U) 

The following are changes or additions to the System Management Guides 



1.2.7.1 Virtual Console Routine (VMR) - RSX-llM now supports the 
following VMR SET keywords: 

• /RNDC - Defines the length of the Executive round-robin 
scheduling interval. 

• /RNDH - Defines the highest priority that will be considered 
for Executive round-robin scheduling. 

• /RNDL - Defines the lowest priority that will be considered 
for Executive round-robin scheduling. 

• /SWPC - Defines the length of a single Executive swapping 
interval. 

• /SWPR - Defines a new priority range for Executive swapping. 

• /LA50=ttnn: - Establishes ttnn: as an LA50 (Note that this 
support is not documented in the VMR chapter.) 

The SAVE command supports the following new devices for saving system 
images: RX50, RA60, RC25, TSV05 , and TU80. 

The REDIRECT command has a new error message: 

TT redirect error 

The message means that an attempt was made to redirect terminal (TTn:) 
to the null device. 



1.2.8 RSX-llM/M-PLUS Error Logging Manual (R) 

The following are changes or additions to Error Logging: 

• Error Logging now allows hard and soft limits to be reached 
Independently. Previously, reaching one of the limits would 
disable logging of either kind of error on that device. Now, 
reaching the soft limit will not affect the logging of hard 
errors and vice versa. 

• Device timeouts are now logged as hard errors if unrecoverable 
and as soft errors if recoverable. 

• When generating a report, RPT looks first for 
LX: [1,6] ERRLOG.ULB. LX: is a new pseudo-device used by Error 
Logging. If it fails to find that file, it looks for 
LB: [1,6] ERRLOG.ULB. 
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There have been a number of minor changes in the Control File 

Language (CFL) component of the Error Logging System. The 

following lists the differences between CFL in RSX-llM V4.1 
and the previous releases. 

%CNV$xxx functions: 

The field_width parameter is now optional and interacts 
with the optional fill character parameter to determine 
whether the resulting strTng is simply printed as is or is 
left- or right-justified. In the earlier version, the 
digits in the string were always right- justified and blank 
filled if no f ill_character was specified. 

- %LOK$LENGTH function; 

This function always returns the length of the data in a 
packet or subpacket. The length word for the packet or 
subpacket is not considered part of the data and is not 
counted in determining the length value returned. 

- %LOK$BYTE, %LOK$WORD, %LOK$LONGWORD functions: 

The offset parameter is the offset within the data of the 
packet/subpacket at which the byte, word, or longword 
begins. The offset unit is always in bytes, with the first 
byte of data in the packet/subpacket being offset 0. 

- %STR$UPCASE function: 

%STR$UPCASE accepts an ASCII string as a parameter, and 
returns the ASCII string with all the lowercase ASCII 
characters converted to uppercase. 

- DYNAMIC_TABLE statement: 

This new statement is a synonym for the FILE statement and 
should be used instead of FILE in any new code. 

FILE statement: 

The FILE statement will be removed in a future release. 
You should replace any FILE statement presently in your 
code with the DYNAMIC_TABLE statement. 

- WRITE and WRITE_GROUP statements: 

Because of overlay restrictions, the following operators 
and functions cannot be used in expressions in WRITE or 
WRITE_GROUP statements: 

single and double operand numeric operators 

the MATCH operator 

%COD$xxx functions 

%CTL$xxx functions 

%PKT$xxx functions 

%RPT$xxx functions 

%STR$xxx functions 

%TIM$xxx functions 

%USR$xxx functions 
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The RSX-llM/M-PLUS Error Logging Manual has two new chapters. 

- Chapter 4, Error Logging Control File Architecture, 
explains the control file modules in detail, including flow 
of program control, interface between modules, and module 
dispatching. A knowledgeable system programmer can use the 
information here to add user-written modules to the Error 
Logging System. The chapter includes extensively annotated 
examples of DIGITAL-supplied modules. 

Chapter 5, Control File Language Guide, describes the 
Control File Language, which is used to write control-file 
modules. 



1.2.9 RSX-llM Mini-Reference (R) 

This revision to the RSX-llM Mini-Reference consists of a new section 
on RMS-11, as well as technical improvements to several other sections 
of the manual. 

The RMS-11 section includes both procedures for invoking the following 
RMS-11 utilities, and summaries of their commands and keywords. 

• RMSDES (RMS-11 File Design Utility) 

• RMSIFL (RMS-11 Indexed File Load Utility) 

• RMSCNV (RMS-11 File Conversion Utility) 

• RMSDSP (RMS-11 File Display Utility) 

• RMSBCK (RMS-11 File Back-Up Utility) 

• RMSRST (RMS-11 File Restoration Utility) 

In addition, the RMS-11 section lists the RMS-11 completion codes and 
fatal error codes. 

The sections Executive Directives and I/O Error Codes have been 
updated to include new or corrected information. 



1.3 NOTES ON SOFTWARE 

The following sections describe the incompatibilities between RSX-llM 
V4.1 and previous versions, and provide miscellaneous information 
pertinent to the successful use of the software. 



1.3.1 Baseline Systems 

The V4.1 baseline system in [1,54], on the disk labeled RSXM35, 
requires a minimum of 64K words. This is an increase of 36K words 
over the minimum memory requirement for V4.0. 
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1.3.2 System Generation and Installation 

The host machine for a system generation must meet the following 
minimom requirements: 

• Must have at least 64K words of memory 

• Must be mapped and have a null device (NL:) 



1.3.2.1 Performing an RSX-llM V4.1 SYSGEN on a V3.2 System - If you 

intend to perform an RSX-llM V4.1 system generation while running 
under a V3.2 system, you must do the following: 

1. Update several modules in the V3.2 indirect object library 
(IND.OLB) . 

2. Rebuild big indirect (BIGIND) . 

3. Use the TKB and VMR tasks from the V4.1 distribution kit when 
performing the SYSGEN. 

There is a concatenated object file, INDFIX.OBJ, in UFDs [12,20] and 
[12,24] of the RSX-llM V4.1 distribution kit that simplifies the 
updating of IND.OLB. This object file consists of the individual 
updates to four indirect modules: INDPRC, INDPAR, INDOPN, and INDSET. 
The procedure for updating is as follows: 

1. Set the UIC to [1,20] for an unmapped system or [1,24] for a 
mapped system. 

2. Copy INDFIX.OBJ to the disk that has the most recent version 
of V4.0 IND.OLB. 

3. Issue the following command: LBR IND/RP=INDFIX. 

4. Assign the logical names TK (task image device) and MP (map 
device) to their proper devices: for example, ASN LB:=TK: 
and ASN NL:=MP. 

5. Task-build the big indirect task as follows: TKB @BIGINDBLD. 

6. Remove the current indirect ( REM ...AT.). 

7. Install the newly created big indirect (INS $BIGIND) . 

8. Mount the V4.1 baseline distribution kit (RSXM35) , and 
install the TKB and VMR tasks from it. The tasks are in 
[1,54]. 

9. If your system does not have extend task support, and there 
is ample memory available, install the V4.1 TKB with an 
increment: for example, /INC=20000. 

10. Use the V3.2 BIGMAC (or the V4.1 MAC) for the system 
generation. As with TKB, installing BIGMAC with an increment 
will speed up processing if your V3.2 system does not have 
extend task support. 
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Once you have completed this sequence of steps, you are ready to 
perform an RSX-llM V4.1 SYSGEN. Refer to the RSX-llM System 
Generation and Management Guide for instructions on performing an 
on-line SYSGEN. 



1.3.2.2 Restriction to V4.1 On-Line SYSGEN - When performing a V4.1 
on-line SYSGEN, SYSGEN will always install the Task Builder supplied 
on the distribution kit (...TKL). 

This restriction is due to changes made in TKB to generate a new 
autoload vector format for overlaid tasks. These changes are closely 
coupled with the overlay run-time system found in SYSLIB and result in 
incompatibility problems between the old TKB and SYSLIB. Therefore, 
in order for SYSGEN to execute successfully, the tasks that SYSGEN 
needs must be built with the V4.1 TKB. 



1.3.2.3 V4.0 Saved Answer Files - A V4.0 saved answer file 
(SYSSAVED.CMD) can be used when generating a V4.1 system. These files 
are now upward compatible. However, two new SYSGEN questions 
regarding checkpointing and SPM-llM support will be asked. 



1.3.2.4 Determining the Number of RK05 Units - Fixed platter RK05 
drives (RK05F) are handled as two units. The first of each RK05F pair 
must be an even unit number; for example, and 1, 2 and 3. Be sure 
to take this into account when calculating the number of RK05 units. 



1.3.2.5 SYSGEN on RLOls or RL02s -Due to the space limitations of 
the RLOl and the RL02, you should not perform more than one SYSGEN on 
the disk without first clearing some space on it. This clearing can 
be accomplished by copying files to another media and then deleting 
the unnecessary files. 



1.3.3 User Account for the Warm-Up Session 

The Introduction to RSX-llM and RSX-llM-PLUS includes a warm-up 
session for new users. A number of files that are associated with the 
warm-up session are included on the RSX-llM kits, along with a few 
other files intended for the convenience of all users. 

During the post-SYSGEN clean-up procedure, while extracting the HELP 
files, you are asked if you wish to extract the INTRODUCTORY files. 
If you answer Yes to this question, the command procedure will extract 
a module from HELP.ULB called INTRO. ULB. 

All the introductory and convenience files are contained in INTRO. ULB. 
Extract the module called INTROF, using the following procedure: 

MCR> LBR INTROFIL . CMD=INTRO. ULB/EX : INTROF 

or 

DCL> LIBRARY/EXTRACT INTRO. ULB INTROF 
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This module is an indirect command file called INTROFIL.CMD, which you 
can run to extract all the other files by typing: 



The procedure extracts 20 files, including WHATSHERE.TXT, which 
explains what all the other files are. You can use these files in two 
ways, depending on the number of new users you have coming on to your 
system. 

In UFD [200,1] on your target system disk are introductory files used 
with the warm-up session for new users presented in the Introduction 
to RSX-llM and RSX-llM-PLUS and RSX-llM-PLUS manual. When new users 
come onto the system, the system manager should have them use the 
account with the UIC [200,1] and the account name USER which has been 
supplied with the distribution kit. New users can log in to this 
account and follow through the entire warm-up session. See Section 
6.2.9 of the RSX-llM System Generation and Installation Guide and 
pages 1-5 to 1-7 in the Introduction to RSX-llM and RSX-llM-PLUS . 

Alternatively, the system manager can copy the introductory files to 
the new user's own account, then instruct the new user to delete these 
introductory files when he or she has finished with the warm-up 
session. 

Use the convenience files as you wish. They are marked with a * in 
the list below. 

*A.A;1 *SUCCESS.TSK;1 

*WARNING.TSK;1 *ERR0R.TSK;1 
*SEVERE.TSK;1 LOGIN.CMD; 1 

DELETE. CMD;1 *C LOCK. MAC ; 1 

SH0W.CMD;1 *CLKGEN.CMD; 1 

STARS. MAC ;1 FLY. TXT ;1 

TEXT. TXT ;1 FLY, TXT; 2 

CLEAN.CMD; 1 * WHATS HERE. TXT ; 1 
*TMCLI,MAC;1 SHAVE.CMD; 1 

*TMCLI,FTN;1 HIYA.MAC;1 

For more information on extracting HELP files from RSX-llM kits, see 
Chapter 6 of the RSX-llM System Generation and Installation Guide . 



1.3.4 BRU64K Restriction 

On an BRU64K stand-alone system, you should not run BRU and BAD 
simultaneously. Because BRU and BAD use common buffer space, running 
both tasks at the same time yields unpredictable results. 



1.3.5 DSC64K, DSCSYS, and BADSYS 

The DSC64K, DSCSYS, and BADSYS stand-alone systems have been removed 
from the distribution kits. These stand-alone systems are no longer 
needed, as BRU64K is now used as the stand-alone system. 



1.3.6 Power-Fail Recovery 

A disk driver is called at its power-fail recovery entry point when a 
power— i.aij. occurs. This recovery routine gives a disk sujLficient time 
to spin back up and be ready to accept I/O requests. 
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There are three possible recovery procedures: 

1. If a device is busy prior to the power-fail and the requested 
I/O has not completed, the routine times out and checks the 
device status until the device is ready for I/O operations to 
resume. 

2. If a device is not busy prior to the power- fail and receives 
an I/O request after the power- fail, the routine times out 
and checks the device status until the device is ready for 
I/O operations to resume. 

3. If a device is not busy prior to the power-fail and there are 
no pending I/O requests, operations resume with no special 
handling by the recovery routine. 

Note in the first two cases that, if the maximum time-out count is 
reached before the disk spins back up and is ready, an unsuccessful 
I/O completion code is returned. 



1.3.7 Change to Executive's Task Abort Code 

The Executive's task abort code has been modified. If you install an 
Ancillary Control Processor (AGP) task with post-mortem dump (PMD) 
enabled and this task aborts, then the system will crash. A crash 
dump is produced, which shows the state of the I/O data structures at 
the time the ACP task aborted. By default, most DIGITAL-supplied ACPs 
are installed with PMD enable. 



1.3.8 Restriction to Error Logging 

By moving the Error Logging routines into the Executive Common, the 
following restriction is introduced: If a driver of an error logging 
device calls the $CRPKT routine to create an error logging packet, the 
data address for the data subpacket must not be an address within the 
driver. Specifically, the address must not be mapped by APR 5, as 
that APR is used to map the common. Any user-written driver that 
performs such a function must allocate a piece of pool, fill in the 
appropriate information, and pass the pool address to the create 
packet routine. 



1.3.9 TDX (Catch-All Task) 

Support for TDX, the catch-all task, is provided with RSX-llM systems. 
The primary purpose of the catch-all facility is to give you the means 
to run uninstalled tasks. 

Any task installed with the task name ...CA. is treated as a 
catch-all task. If the Monitor Console Routine (MCR) receives an 
unrecognized command, it searches for a task with that name and passes 
the command line to this task. To use TDX as the catch-all task for 
your system, install it as follows: 

> INS $TDX/TASK= . . . CA. 
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TDX checks the typed command against its list of commands. If the 
commands match, TDX translates the command into a legal MCR command. 
These commands and their MCR translations are: 



CoRoaand 

ATS 

ATS ttnn: 
CHD 

CHD g m 

CLR 



Translation 

ACT /ALL 

ACT /TERM=ttnn: 

SET /UIC 

SET /UIC=[g,m] 



CRE file 



CVT val 



PIP file=Tl! 



DEL file(s) PIP file(s)/DE 



DIR [file(s)] PIP [file(s)]/LI 



DLG 



DEV /LOG 



Meaning 

Display the names of 
all active tasks in 
the system. 

Display the names of 
all active tasks on the 
specified terminal. 

Display the current 
default UIC for 
terminal TI : . 

Change the default UFD 
to the UFD specified. 

Clear the issuing 
terminal's screen and 
set cursor to 0,0. 
Returns exit status of 
EX$SUC if terminal is 
a CRT, and EX$WAR if 
it is not. 

Create a new file 
without invoking an 
editor. 

Evaluate an arithmetic 
expression, convert 
that expression into 
different formats, and 
display all the formats 
on your terminal. CVT 
accepts input in octal 
(nnn or nn,nn) or 
decimal (nnn. or 
nn.,nn.) words or 
bytes, hexadecimal 
numbers ($nnnn) , 
radix-50 (%ccc) or 
ASCII ('c or "cc) 
characters, or 
arithmetic expressions 
using +,-,/,* and < >. 

Delete the 
specified file(s) . 

Display a directory 
listing at the 
terminal . 

Display information 
about all the 
logged-in terminals 
on the system. 



1-25 



RSX-llM V4.1 RELEASE KOTES 



Command 

DLN 

PRE 



Translation 

NCP SHOW KNOWN NODES 

PIP /FR 



PRE ddu: 



PIP ddu:/FR 



PUR file(s) PIP file(s)/PU 



SHQ 



SYS 



TDX 



SHOW QUEUE ALL 



SET /SYSUIC 



TYP file(s) PIP TI:=file(s) 



Meaning 

Display all known 
DECnet nodes. 

Display the amount 
of available space 
on SY: , the largest 
contiguous space on 
SY: , the number of 
available file headers, 
and the number of file 
headers used. 

Display the same 

information as PRE 

for a specified device. 

Delete all but the 
latest version of 
a file. 

Display information 
about all entries in 
all print queues. 

Display the current 
system UIC. 

Display the current 
version of TDX. 

Print files on your 
terminal. 



You may want to add other commands to TDX by modifying the source 
file in [24,10]TDX.MAC. The routines for the commands are at the 
end of the source file and serve as examples for user-tailored 
routines. To reassemble the source file after making additions, use 
the TDXASM.CMD file located in [24,20]. To rebuild TDX, follow the 
procedure in the Phase III section of the RSX-llM System Generation 
and Installation Guide . TDX comes preassembled { [1,24] TDX. OBJ) if 
you do not wish to make any changes. 



Location of files on multivolume kits 



Distribution 

RLOl/02 
RK06/07 
(all other) 



TDX. MAC 

HLPDCL 
CLISRC 
RSXM35 



TDX. OBJ, TDXBLD.BLD 

EXCPRV 
RSXM35 
RSXM35 



If the user's typed command does not match any of TDX's commands, 
TDX attempts to issue one of the following two MCR command options. 
In the examples, XXX represents the first three characters of your 
command. 

The option TDX uses depends on whether the logical devices ZZl: or 
ZZ2: exist on your system. You can assign one of these devices in 
your LOGIN.CMD file. Note that the presence of the ZZl: assignment 
masks the presence of the ZZ2: assignment. If no assignment is 
made, TDX will not exercise either option. 
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MCR> RUN $XXX/TASK=XXXTTN/CMD=''params.. ." 

"Params..." represents the command line that you enter. 
Your command line cannot exceed 39 characters, because TDX 
adds other characters to this line. If you want this 
option, place the following in your LOGIN.CMD file: 

ASN SY:=ZZ1: 



2. 



MCR> @SY: [loginuic]XXX.CMD or 
MCR> §LB: [libuic3XXX.CMD or 
MCR> @SY: [loqinuic3CATCHALL.CMD or 
MCR> @LB: [libuic]CATCHALL.CMD 

For this option, TDX searches for one of the §[ . . .jXXX.CMD 
indirect command files, in the order indicated. As soon as 
TDX locates one of these files, the search stops. You can 
design the indirect command file to perform a variety of 
functions, such as installing tasks, providing HELP, or 
issuing error messages. 

If you want this option, place the following in your 
LOGIN.CMD file: 

ASN SY:=ZZ2: 

RSX-llM V4.1 contains a sample indirect command file, 
[24,24] CATCHALL.CMD. 

The ZZn option may be controlled for all users by placing the 
following command in the system startup file: 

ASN SY:=ZZn:/GBL 

where n equals 1 or 2, depending upon which ZZn option you prefer. 

TDX issues the following message if the user's command does not 
match a TDX command or if TDX cannot locate the necessary task. 

MCR — Task not in system 

You may wish to install some tasks permanently, rather than invoking 
TDX to install them on an as-needed basis. It is advisable to 
permanently install: 

• Tasks requiring a larger increment than the default (see the 
INSTALL command in the RSX-llM/M-PLUS MCR Operations Manual ) 

• Frequently used tasks 

There are two cases, when noninstalled tasks are invoked by indirect 
command files, where TDX may affect the execution of the command 
file: 

• If the command line's length exceeds 39 characters 

• In systems without Parent Offspring tasking, TDX has no 
means of returning the exit status of called tasks to 
Indirect. In this case. Indirect proceeds immediately to 
the next command line without waiting for the called task to 
finish. This has the same effect as preceding the command 
line with .XQT. 
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1.3.10 Restriction for DCL as the Catch-Ail Task 

If your command line interpreter is set to MCR and DCL is installed 
as the catch-all task (...CA.), do not use the DCL INITIALIZE/UPDATE 
command to modify your disk parameters. When you enter this 
command, MCR interprets the INI portion of the command to mean 
INITIALIZE VOLUME, and consequently destroys all existing files on 
your disk. As alternatives, either use the MCR HOME command or set 
your command line interpreter to DCL before using the 
INITIALIZE/UPDATE command. 



1.3.11 Indirect Command Procedure Library 

Users wishing to use the Indirect command procedure library 
INDSYS.CLB (as documented in the RSX-llM/M-PLUS MCR Operations 
Manual ) must copy it from the MCR source volume directory to their 
system volume. 

On single disk distribution kits (RP04/5/6 or RM03 , for example), 
copy the file as follows: 

PIP LB: [1,2]=LB: [12 , 10] INDSYS.CLB 

On multidisk distribution kits (RLOl/02, for example), mount the MCR 
source volume and copy the file as follows: 

PIP LB: [l,2]=dd: [12,10]INDSYS.CLB 

The characters dd represent the drive on which the MCR source volume 
has been mounted. 

For the RK06/07 kit, the file is on CLISRC; and for the RLOl/02 
kit, the file is on MCRSRC. 



1.3.12 Indirect Command Processor Support for V4.1 

Following are descriptions of the three versions of the Indirect 
Command Processor that are supported in RSX-llM V4.1. 

• The first version is called ICP and contains the same 
functional parameters as the IND task released in V4.0. 
This version requires a 12K partition size and must be used 
when you are doing a V4,l SYSGEN. ICP is the standard 
Indirect created during the Phase II privileged task build. 
There is no FCSRES version of this task. 

• The second version is called ICQ and is more heavily 
overlaid in order to fit in an 8K partition. This version 
supports ,the minimum of functional parameters necessary to 
execute a command file that does not exceed the following; 

1 concurrently open data file 

- 1 parallel XQT directive 

2 Direct Access Labels 

- 1 GOSUB nesting level 

2-level depth of open command files 

- 108 (decimal)-byte command file input buffer 



1-28 



RSX-llM V4.1 RELEASE NOTES 

ICQ is designed for systems that lack sufficient memory space 
to support a 12K task. ICQ's execution time is slower than 
ICP's, and its symbol table space and functional parameters 
are insufficient to complete a SYSGEN. ICQ is built during 
SYSGEN only if the target system contains less than 24K of 
memory. 

• The third type of task is the resident PCS (FCSRES) version of 
ICQ. This task is also highly overlaid and is slower than 
ICP; however, this version has the same functional parameters 
as ICP with approximately the same symbol table space as ICQ. 
The task resides in an 8K partition and has the following 
parameters: 

4 concurrently open data files 

- 16 parallel XQT directives 
16 Direct Access Labels 

8 GOSUB nesting levels 

4-level depth of open command files 

- 132 (decimal)-byte command file input buffer 

This version is designed for systems that lack sufficient memory 
space to support a 12K task but still want to retain the full 
capabilities of the ICP task. However, it does not contain enough 
symbol table space to complete a full SYSGEN procedure, and it must 
be built as a privileged task with FCSRES support using the SYSGEN3 
procedure. 



1.3.13 Task Builder Restrictions 

The following two restrictions apply to the V4.1 Task Builder. 

• You may experience problems if you use the V4.1 Task Builder 
(task version M40.10) with a SYSLIB other than the one 
supplied with V4.1. Changes and additions have been made to 
the overlay run-time system modules that make them 
incompatible with previous versions of SYSLIB. OLB. 

• The first library in a cluster of libraries may or may not 
be overlaid and may or may not have a null root. The 
remaining libraries in the cluster must be overlaid with a 
null root. The first library in a cluster is the one named 
first in the Task Builder cluster (CLSTR) option. 

Severe performance degradation can occur with cluster 
libraries if you have one of the following two conditions in 
your task: 

1. The first library is overlaid and has a null root. 

2. The first library called by the task is not the first 
library specified in the CLSTR option. 
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If the first library in the CLSTR option is overlaid and has 
a null root, the overlay run- time system cannot distinguish 
the first library from the remaining libraries in the 
cluster. The Task Builder therefore assumes that the first 
library called by the task is the first library; this first 
library is the one that Task Builder consistently maps by 
default. Therefore, although the preceding two conditions 
do not cause errors, they may cause performance degradation 
because of excessive mapping and unmapping of libraries in 
the cluster. 

To avoid this problem, the library first called by the task 
should be the first library specified in the CLSTR option. 



1.3.14 Modifications to System Library Task Builder Data Structures 

Beginning with the V4.0 release, the Task Builder and the associated 
overlay run-time system incorporate new overlay functionality and 
modified data structures. 

New modules are included in the system library to support cluster 
libraries (see the RSX-llM/M-PLUS Task Builder Manual for a complete 
description of this feature) . In order to minimize the virtual 
memory impact of the new features, some changes were made in the 
older modules. The customer product that used the run-time routines 
may not build correctly or may malfunction unless minor changes are 
made, in particular, the following points are relevant: 

• The run-time routines reference the register save routine, 
.SAVRl instead of .SAVRG. In some overlaid applications, 
this routine may have been explicitly loaded in an overlay 
(for example, as part of a tightly overlaid FGS-11). This 
reference results in a "Multiply defined global" message 
from TKB. The change is to remove explicit .SAVRl 
references from overlay specifications in the .ODL file and 
to let TKB place this module in the root with the overlay 
run-time routines. 

• The linkages between the various overlay run-time modules 
have_ been modified slightly to support the new library 
mapping; therefore, users who have developed debugging 
tools that "hook" themselves into the overlay system should 
refer to a copy of the source microfiche or the source kits. 



1.3.15 Transportability among 22-bit Systems 

RSX-llM supports transportability among all 22-bit systems. These 
systems can differ as to whether the Executive handles NPR transfers 
by performing memory management functions, or the hardware has its 
own 22-bit physical memory addressing capabilities. 

To make these systems transportable, you must boot your target 
system on the processor selected at SYSGEN and then SAVe it. The 
saved system will then be hardware bootable and transportable amopg 
the different 22-bit systems. 
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1.3.16 Device Drivers and User Tasks 

The addition of new and enhanced device support to RSX-llM V4.1 may 
»^..„« r>.-ni^l ome fnr o^m<a iicai- l-aejtc in v A ^ Th *» rh;irar;hpri shies of 

the device drivers and the procedures recommended for handling such 
problems are described as follows: 

• The UDA50 (DUDRV) dynamically updates the system data base 
to reflect the characteristics of the disk. 

Recommended action: User tasks should issue a QIO Attach 
function before requesting the device's characteristics with 
the GET LUN directive. 

• The TMllA/B device driver (MTDRV) dynamically updates the 
system data base to reflect the density characteristics of 
TEIO/TUIO. 

Recommended action: User tasks should issue a QIO function 
using the function codes for the powerfail recovery 
procedure, as described in the RSX-llM/M-PLUS I/O Drivers 
Reference Manual , before requesting the device's density 
characteristics with the GET LUN directive. 

• The RX02 device driver (DYDRV) dynamically updates the 
system data base to reflect the characteristics of the media 
in the RX02 drive. 

Recommended action: User tasks should issue a QIO Sense 
Characteristics function b'efore requesting the device's 
media characteristics with the GET LUN directive. 

• Users issuing QIOs directly to MSDRV must be aware of the 
following : 

1. The completion of the lO.RWD request occurs when the MS: 
device reaches BOT. 

2. When the MS: device changes status from either off-line 
to on-line or from on-line to off-line, the MS: device 
inhibits further physical I/O operations. After such a 
change, the user must issue either an lO.RWD or an 
lO.SMO request that succeeds before I/O operations 
resume. 

3. MS: read/write data transfer features are as follows: 

The data buffer starting address must be on a word 
boundary. 

The data transfer size can be an odd or even byte 
count. 

The user can swap the odd and even data bytes by 
using the tape characteristic bit 1 of lO.SMO or 
lO.STC requests. When bit 1 is set to 0, no byte 
swap occurs. When bit 1 is set to 1, the byte swap 
does occur. If you use byte swapping, it is 
recommended that the data buffer size be an even byte 
count. 
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1.3.17 Changes to Code and Data Structures for Privileged Tasks 

The changes documented in this section were new for RSX-llM V4.0 
rather than for V4.1. This information is included here because it 
has not yet been incorporated into the documentation set. 

Many of the changes made to RSX-llM Version 4.0 may affect the 
upgrading of privileged tasks and drivers that were written for a 
previous release. 

The following sections describe the most significant changes to code 
and data structures since the previous release. 

Note that nonprivileged tasks should not be affected by any of these 
changes. 



1.3.17.1 Changes Made to Executive Code - 

• The module lOSUB.MAC has been divided into four modules: 
lOSUB, EXESB, MEMAP, and MDSUB. The last three are new. 

• The Get Partition Parameters directive now returns the real 
virtual starting address of a privileged task's task region 
instead of as it did in Version 3.2. 

• Many Executive routines have been moved into the Executive 
commons (if Executive common support was selected). 
Therefore, it may not be possible for privileged code to 
reference these routines as they may have done in a previous 
release. To determine if an Executive entry point is in an 
Executive common, consult RSXllM.MAP, The entry point is in 
a common if its address falls between 120000 and 140000. 

If the entry points are inaccessible to the task because 
they reside in the Executive commons, a procedure for 
accessing that routine is available. A transfer routine 
must be written by the user that will permanently reside in 
the mapped Executive address space. See module DRSUB for 
examples of transfer routines. Note that transfer routines 
are already provided for the most commonly called 
subroutines now moved into the commons and their existence 
is transparent to any task referencing them. 

• The RSXMC.MAC symbol P$$D70 which indicated cache memory on 
a 22-bit processor has been changed to C$$CHE. 



1.3.17.2 Changes Made to Executive Data Structures - 

• The Task Control Block (TCB) has undergone many changes. 
The present format can be found in an appendix of the 
RSX-llM/M-PLUS Crash Dump Analyzer Reference Manual . The 
following offsets are new: 

- T.TIO Buffered I/O count (byte) 

- T.TKSZ Initial task size (root) 

- T.EFLM Event flag waitfor mask and mask address 

- T.HDLN Task header length in 32 word blocks (byte) 
T.GGF Task group global event flag use count (byte) 
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To enhance asynchronous buffered I/O, the bit T2.TI0 that 
allowed for only one buffered I/O per task, has been changed 
to the byte T.TIO. This byte allows a task to queue many 
buffered I/O requests simultaneously. 

The word at offset O.STAT+2 of the offspring control block is 
now used to contain a secondary exit status, the TKTN abort 
code, which is filled in whenever the offspring exits. 
Previously, only the word at O.STAT was used. Note that more 
words in the exit status region of the OCB may be used in the 
future and therefore should be considered as reserved for 
future expansion. 

The addition of alternate CLI support has changed how CLIs are 
associated with individual users. On systems that include 
alternate CLI support, the word previously at offset U.CLI in 
terminal UCBs, (DV.TTY is set) has been redefined. On these 
systems it is referred to as U.MUP, since it now contains a 
bit mask for various multiuser features. Bits 1 - 4 in this 
word are now used to identify the CLI associated with that 
terminal. The bits form an offset into a table located at 
$CPTBL in the Executive module SYSCM. This module contains a 
pointer to the CPB (CLI Parser Block) for the CLI. Since only 
four bits are used to form this offset, the system is limited 
to 16 CLIs. The bit that is used for the NOBROADCAST feature 
is also in this word, which is why this feature is only 
available on systems supporting alternate CLIs. 

There are now two additional feature mask words. These words 
are documented in an appendix of the RSX-llM/M-PLUS Crash Dump 
Analyzer Reference Manual . These words are accessed as 
positive offsets from the original feature mask word, $FMASK. 



..3.17.3 Changes Hade to I/O Data Structures - 

• The bit DV.MXD in offset U.CWl of the UCB (previously for 
mixed MASSBUS) has been changed to DV.MSD. This bit is set 
for all mass storage devices, and must be turned on for all 
user-written drivers that want to support error logging. In 
addition, error logging devices must have four words 
preceding each UCB (negative offsets) . 

• The bit DV.SWL in offset U.CWl of the UCB (previously 
unused) is now used to maintain the software write-lock 
status of the device. 

• Prior to V4.0, two words were added to the end of each DHll 
UCB to contain the vector and CSR of an associated DMllBB. 
In V4.0, these two words were eliminated. The information 
is now contained in fork block offsets in the SCB. 



1.3.18 MACRO-11 

The maximum number of relocatable terms in a complex expression has 
been changed from the old maximum of 6 to 20. This change was made 
by increasing the maximum size of the .OBJ record that MACRO-11 
produces from 42 (decimal) bytes to 128 (decimal) bytes. 



1-33 



RSX-llH V4.1 RELEASE NOTES 



You cannot verify that code generation is correct by comparing .OBJ 
files created by different versions of MACRO-11. The correct way to 
verify code generation is to task-build the .OBJ files, then compare 
the .TSK image files. 

Because the .OBJ files produced by the new version of MACRO-11 
differ from those of previous versions, you must recompute checksums 
using the PAT utility for any object patches assembled with this 
version of MACRO-11. 

See the Release Notes at the end of the PDP-11 MACRO-11 Language 
Reference Manual for documentation of the changes to MACRO-11. 



1.3.19 Restriction for EDT Version 2.0 

These restrictions apply to V2.0 of EDT, which is a layered product 
bundled on your RSX-llM V4.1 distribution kit. 

Before EDT can be run in keypad mode, your terminal must be set to 
lowercase (SET /LOWER). If the terminal is not set lowercase, the 
terminal driver converts the escape sequences sent by the keypad 
keys into uppercase and EDT does not recognize them. 

Also, if you type CTRL/C while EDT is writing the output file (that 
is, after you type the EXIT command but before the CLI prompt 
appears) , EDT stops writing the output file. No message is 
displayed to indicate that your output file has been only partially 
written. 



1.3.20 Changes to the Conmand String Interpreter (CSI) 

The Command String Interpreter (CSI) was rewritten for Version 4.0 
of RSX-llM to incorporate new functionality. The IAS/RSX-11 I/O 
Operations Reference Manual documents a list of changes to CSI. 

Two additional changes are: 

1. .CSIl no longer references the module ODCVT. 

2. .CSI2 no longer references the module ODCVT and now 
references 0D2CT. 

These changes are normally not visible to the user, but could be a 
problem for some overlaid tasks. 



1.3.21 Bootstrapping a DB-, DM-, or DR-Based System 

The MCR BOOT command can loop indefinitely when it boots a system 
from an RP04/05/06 or an RK06/07 or an RM03/05/80 or an RP07 if it 
encounters an ECC correctable error when reading the system image. 
The bootstrap driver is not large enough to include ECC logic. 
Therefore, it retries the read operation, and never succeeds. 

To recover from this error, use PIP to copy the system image to 
another area on the disk and retry the boot operation. 
Alternatively, you can copy the entire image to another disk and 
boot from that one. 
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1.3.22 Correction to Multiuser MCR on an Unmapped System 

The multiuser version of MCR will not task-build properly for an 
unmapped system. Before doing a SYSGEN, locate the file 
[1,26]MCMBLD-BLD. Edit the file and change the line 

.DATA PAR=GEN: •$GPB' : 20000 

to 

.DATA PAR="$GEN' 

For the RLOl distribution kit, the file can be found on the EXCPRV 
disk. 



1.3.23 File Transfer Program (FLX) 

The behavior of FLX in handling an error during a copy operation to 
an RT-11 device has changed. Previously, FLX allowed a partial file 
to be created on the output device when insufficient space existed 
on the output disk with the same name as the newly created partial 
file. FLX deleted the preexisting file and substituted the partial 
file. This replacing of an existing file with a partial file 
resulted in a loss of information. 

Now, if an error occurs during the copy operation, the partial file 
is not substituted for an existing file on the output disk. The 
partial file no longer is closed as a permanent entry, and the 
definition and contents of the existing file remain intact. 



1.3.24 Incorapatibilty Problem with BRU Tapes 

Because of BRU's new sort algorithm, V4.1 can read V4.0 BRU backup 
tapes, but V4.0 BRU cannot read V4.1 BRU backup tapes. 



1.3.25 Device Restrictions 

The following device restrictions apply to RSX-llM V4.1: 

• MCR/DCL 

The MCR/DCL SET and SHOW commands do not recognize the LPQ02 
letter-quality printer. 

The DCL SET and SHOW commands do not support the LA50 
personal printer. 

• File Transfer Program (FLX) 

The following devices do not support DOS-11 or RT-11 format: 

RC25 
RA60 
RA81 
RD51 
RX50 
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• Disk Volume Formatter (FMT) 

The following devices are not supported: 

RD51 
RX50 
RA60 
RA81 
RC25 
RP07 

• Bad Block Replacement Control Task (RCT) 
The RX50 does not have an RCT area. 

• Virtual Monitor Routine (VMR) 



The SAVE command does not recognize the following 
devices: 

RA81 
RD51 

- The SET command does not recognize the following devices: 

LNOl 
LP26 
LP27 
LP07 
LQP02 

• Error Logging 

The Error Logging control files do not have device-specific 
information for the following devices: 

RD51 
RX50 

• Crash Dump Analyzer (CDA) 

The following fixed disks cannot serve as CDA devices: 

RA80 
RA81 
RD51 
RC25 (nonremovable) 



1.3. 26 Queue Manager 

The MCR /NM switch suppresses messages from the Queue Manager (QMG) 
such as "Queue already exists," 

In DCL, the equivalent switch is /NOWARNINGS. 

Once a queue has been established, it will remain until eliminated, 
in spite of system crashes. But it is desirable to attempt to 
reestablish the standard print queues each time the system is 
bootstrapped, in case a queue has been inadvertently eliminated. 
Issuing a QUE LPO:/CR command, though, yields the "Queue already 
exists" message from the QMG if the LPO queue has not been 
eliminated, as is generally the case. 
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The /NM switch, therefore, is used in the prototype STARTUP.CMD 
supplied on the distribution kit to reduce the "clutter" that is 
printed on the console terminal when STARTUP.CMD is invoked. 



1.3.27 Building the COBOL-81 Compiler 

If you are installing COBOL-81, you must answer the following 
dialogue prompts as indicated in order to build the COBOL-81 
compiler correctly: 

Do you want to build the default compiler <YES>? 

Do not take the default. You should type: NO 

The next two questions in the dialogue concern CIS and RMS. 

The first of these two questions is: 

What should be the compiler task size in K words (legal range 
from "26" to "31") <31>? 

The legal range for the compiler task size actually is 25 to 30 K 
words. Do not use the default for this question; type the 
numerical value of the compiler size from the revised legal range. 

Note that you should not respond with 25 to this question either. 

The next question asks whether you want to change the default of any 
of the compiler switches. You can either take the defaults or 
change them. 

The entire COBOL-81 dialogue is documented in the COBOL-81 
Installation Guide. 



1.4 REPORTING PROBLEMS AND APPLYING CORRECTIONS 

RSX-llM/RSX-llS includes several features to use if you encounter 
questions or problems with your system or if DIGITAL provides 
temporary patches to improve its software performance. 

Software Performance Reports (SPRs) allow you to report any problems 
directly to DIGITAL. The procedure for submitting an SPR is 
described in Section 1.4.1. 

Sections 1.4.2 and 1.4.3 describe how to apply temporary software 
corrections to your system. You should use instructions to apply 
manual patches that are given either in a DIGITAL response to an SPR 
or in a Software Dispatch article. 

Note that any patches in the Software Dispatch are temporary and 
will be overriden by future DIGITAL Updates. An Update is a 
periodic software fix to your system, distributed in the form of 
machine-readable code. DIGITAL customers who are under warranty or 
who have purchased any level of software product service will 
receive the Software Dispatch and Updates. 
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1.4.1 Software Performance Report 

When you complete an SPR form, describe only one problem per form, 
to simplify record keeping and facilitate a more rapid response. 

An SPR can be used for the following: 

• Software errors 

• Documentation errors when the documentation comment form is 
not appropriate 

• Inquiries 

• Suggestions 

• Follow-up on a previous SPR 

An SPR cannot be used for the following: 

• Software license and price policies 

• Obvious hardware problems 

• Logistical or clerical problems with kits or with Software 
Dispatch, such as blank media, or failure to receive the 
Software Dispatch 

• Problems with user-written software 

There are three categories of reports that you can send: 

• Problem/error 

This type of report should have a priority of one to five. 
(Answer is generated.) 

• Suggested enhancement 

This type of report contains suggestions or queries that are 
brought to the development group's attention and has a 
priority of five. (No answer is generated.) 

• Other 

This type of report contains queries and suggestions that 
are priority five. (Answer may be generated.) 

The priority numbers are as follows: 

1. Most production work cannot be run. 

a. Major system functions are unusable. 

b. System does not boot. 

c. Necessary peripherals cannot be used. 

2. Some production work cannot be run, 

a. Certain functions are unusable. 

b. System performance has declined. 

c. Installation has insufficient excess capacity. 
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3. All production work can be run with some user impact. 

a. Significant manual intervention is required. 

b. System performance has declined but installation has 
excess capacity. 

4. All production work can be run with no significant impact 
on user. 

a. Problem can be patched.- 

5. No system modifications are needed to return to normal 
production. 

a. This category includes suggestions, consultations, or 
errors in documentation. 

Because problems are often difficult to reproduce with a different 
system configuration, please define as precisely as possible the 
state of the system vrtien the problem occurred. Illustrate a general 
problem with specific examples. When you refer to a manual, specify 
the full title and section, table, or page number. 

Please supply the following information (in machine-readable form 
where applicable) when you report a problem: 

1. Crash - A copy of the Executive task-build map, output from 
the console terminal, the SYSGEN saved answer file, the 
Executive STB file, and the crash dump. If the crash is 
reproducible, please accurately describe the details, 
supplying hard copy or user source code when necessary. 

2. Drivers - Controller/device information, software options, 
error log output, copy of device registers, and a sample 
program, 

3. Utilities - A copy of your terminal output, showing setup 
commands, before and after effects, and relevant file 
information. 

4. Task builder - A copy of your terminal output command 
files, the task map, and a dump of the first few blocks of 
the task image. 

5. File system - Corrupted Volume: Output from Verify utility 
and dump of the volume. - Improper results: Error code, 
file header dump, sample program. 

6. Error Log Report generator (RPT) - A copy of the report 
file generated by RPT, either on a hard copy listing file 
or on machine-readable media. 

If a failure occurs when you are running privileged, add-on software 
(for example, DECnet) try to reproduce the failure without the 
additional software. Indicate on the SPR the behavior of the system 
with and without the add-on software. 

The SPR process takes time; therefore, if you have a critical 
problem, contact the local DIGITAL office. In the meantime, read 
the Software Dispatch for news on RSX-llM, which includes changes 
and problems other people have found and solved. 
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1.4.2 Applying Corrections to Source Files 

Interim changes to the Executive, MCR Error Log Control Files, and 
device drivers are made by creating correction files, which are 
processed by the Source Language Input Program (SLP) . SLP generates 
a new copy of the modules that contained errors by applying 
corrections to the source file on the distribution kit. (See the 
RSX-llM/M-PLUS Utilities Manual for complete information on SLP.) 



NOTE 

A new update policy is in effect. All 
software fixes will be distributed as 
machine-readable updates instead of 
patches to be manually entered. Also, 
any patches published in the Software 
Dispatch are temporary fixes that will 
be superseded by the next update. 

After you have applied the corrections and obtained a new version of 
the file, do not delete the original source file. Interim changes 
that may be distributed later are cumulative and depend on the 
contents of the distributed sources. 

Because RSX-llM is distributed on a wide variety of media, it is not 
practical to provide comprehensive examples for applying source 
corrections. In the sample procedures that follow, several 
assumptions are made: You must be a privileged user executing on a 
multiuser, mapped, dual RLOl system with an RLOl distribution kit. 
If your system disk is large, it already contains all the necessary 
files and file transfers are not required. 



1.4.2.1 Updating an Executive Source Module - To update an 
Executive source file (ABCDEF.MAC for example), mount the disk 
labelled EXCPRV and create a SLP correction file named ABCDEF.COR in 
the UFD [11,40]. Then running under UIC [11,10] submit the 
correction file to SLP. For example, you could follow this sequence 
to update REQSB.MAC: 

>SET /UIC=[ll,40j 
>ALL DLl: 
>MOU DLl: EXCPRV 
>ASN DL1:=SY: 
>EDI REQSB.COR 

[CREATING NEW FILE] 
INPUT 



*EX 
[EXIT] 

>SET /UIC=[11,101 

>SLP @[11,40]REQSB.COR 

If the updated Executive module in your system is not a loadable 
driver, and the module is not resident in one of the Executive 
commons, (EXCOMl and EXCCM2) , rebuild the Executive and privileged 
tasks to incorporate the modification. 
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To rebuild, do the following: 

1. Assemble the new module, using the RSXMC.MAC file for the 
target system. 

2. Use LBR to replace the old version of the module in 
RSXllH.OLB on the target system. 

3. Invoke SYSGEN Phase II. 

If the updated Executive module in your system is resident in one of 
the Executive commons, EXCOMl or EXC0M2, the process of 
incorporating the modification is as follows: 

1. Execute the first two steps in the procedure listed above. 
There is no need to rebuild the loadable drivers or 
privileged tasks in this case. 

2. Rebuild the Executive as follows: 

>SET /UIC=[1,24] 
>TKB §RSXBLD 

3. Create a new system image file as follows: 

SET /UIC=[1,54] 

PIP RSXl IM . SYS/NV/CO/BL : XXX . =RSX1 IM . TSK 

Note that XXX should be equal to whatever value was used in 
the original SYSGEN. This value is usually equal to 4 
times your system memory size in 1024 decimal-word blocks, 
plus 2, up to a maximum of 498. 

4. VMR gSYSVMR.CMD 

If the modified file in your system is a loadable device driver 
(ZZDRV.MAC for example) , the updated module can be replaced without 
doing another system generation. Assemble the updated module and 
replace the resulting object file in the RSXllM.OLB of your target 
system. 

Boot the target disk: 

>ALL DLl; 

>MOU DLlzEXCPRV 

>SET /UIC=[1,24] ! [1,20] for unmapped systems 

>MAC ZZDRV=[1,1]EXEMC/ML, [11,10] RSXMC/PA:1, DLliZZDRV 

>DMO DLl: 

>DEA DLl: 

>LBR RSX11M/RP=ZZDRV 

>PIP ZZDRV.OBJ;*/DE 

Use the indirect command file [200, 200] SGNBLDDRV.CMD to produce the 
files ZZDRV.TSK and ZZDRV.STB. If necessary, copy ZZDRV.TSK and 
ZZDRV.STB into the UFD corresponding to the system UIC. 

>@12G0 ,200 ] SGNBLDDRV 



>SET /SYSUIC 

SYSUIC=[g,ro] 
>SET /UIC=[g,m] 
>PIP /NV=[1,54]ZZDRV.* 1 or [1,50] for unmapped systems 
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Use VMR to unload the old device driver and to load the new one. If 
the new driver is larger than the old one, it may not fit into the 
same locations as did the old one. It may be necessary to unload 
and reload all of the loadable drivers in that partition to create 
enough room. If the system is unmapped, some other drivers may have 
to be rebuilt. 

>VMR 

ENTER FILENAMErRSXllM 

VMR>UNL ZZ: 

VMR>LOA ZZ: 

VMR> "2 

>RUN $SHUTUP 

Hardware bootstrap the modified system. 



1.4.2.2 Updating an NCR Source Module - Updating an MCR source file 
is similar to updating an Executive source file. 

NOTE 

For illustration purposes, the 
following discussion applies to the 
RL01/RL02 kit. The illustration is 
adaptable to other types of 
distribution kits. Please refer to 
the table at the end of this section 
for disk labels of other types of 
distribution kits. 

The MCR source files are on a disk labeled MCRSRC in UFD [12,10]. 
The source files for the following modules (referred to as terminal 
driver-dependent modules) appear on two disks, MCRSRC and EXCPRV: 

DV20V 
SPSOV 
SXIOV 
SX20V 
SX30V 
SX40V 
STSUB 

The steps to update a source file for MCR (single-user and 
multiuser) and external MCR tasks are the same. The procedures for 
rebuilding the single-user and multiuser MCR differ slightly. 
Furthermore, if the module is one of the terminal driver-dependent 
modules, the corrections should be applied to source files on both 
disks. An example is provided below for each procedure. 

Convention: The notation [l,2x] represents [1,24] for mapped system 
and [1,20] for unmapped system. 

The following example explains the procedure to update MCR for a 
RL01/RL02 kit. To update the MCR source file SPSOV. MAC, mount the 
RL01/RL02 disk labeled MCRSRC, 

Create the SLP correction file SPSOV. COR and use it to update 
SPSOV. MAC. Assemble SPSOV for the target system. Since SPSOV is a 
terminal driver-dependent module, the correction must be applied to 
source files on MCRSRC and EXCPRV. 
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DLO: is mounted with RSXM35 baseline disk 

>SET /UIC=[12,40] 

>ALL DLl: 

>MOU DL1:MCRSRC ! mount disk with source file 

>ASN DL1:=SY: 

>EDI SPSOV.COR ! creating the SLP correction file 

[CREATING NEW FILE] 

*EX 

[ 

>SET /UIC=[12,10] 

>SLP 8 [12, 40] SPSOV.COR 1 apply correction on MCRSRC 

! assemble the updated module 

I 

>SET /UIC=[l,2x] 

>ASN DLO:=Sy: ! assign SY: to baseline disk 

>ASN DLO:=LB: ! assign LB: 

>MAC SPSOV=[11,10]RSXMC/PA:1,LB: [1 , 1] EXEMC/ML,DL1 : [12,10]SPSOV 

> 

I 

! if module is terminal-driver-dependent, 

! repeat above procedure with the EXCPRV disk 

>SET /UIC=[12,40] 

>MOU DLl: EXCPRV ! mount second disk with terminal-driver 

S dependent source file 
>ASN DL1:=SY: 

>EDI SPSOV.COR ! create same SLP correction file as above 
[CREATING NEW FILE] 

• 
• 

*EX 

[EXIT] 

>SET /UIC=[12,10] 

>SLP @[12,40]SPSOV.COR ! apply correction on EXCSRC 

> 

Single-user and multiuser versions of MCR require different 
procedures for incorporating the modified module into the system. 
The procedures involve the following steps: 

1. Incorporate the updated module into MCR's object library. 
If the module is terminal driver-dependent, append it to 
the file of concatenated MCR terminal driver-dependent 
modules. 

2. Invoke SYSGEN3 to rebuild MCR and install it into the 
system with VMR, ensuring that SY: and LB: are first 
assigned to the disk containing the target system. 

To rebuild single-user MCR, use the following procedure: 

I 

! DLO: is mounted with RSXM35 baseline disk 

! 

>MOU DLl: EXCPRV 

>SET /UIC=[l,2x] 

>LBR DL1:MCR/RP=SPS0V ! replace object module into MCR.OLB 

>PIP DL1:MCR,0BJ/AP=SPS0V. OBJ ! for terminal-driver dependent 

1 modules only 
>PIP SPSOV.OBJ;*/DE ! clean up 
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invoke SYSGEN3 to build privileged task MCR 

>SET /UIC=[200,200] 

>§SYSGEN3 ! refer to SYSGEN Manual for details 



>ASN DLO:=SY: • ensure proper assignments 

>ASN DLO:=LB: i for VMR 

>VMR 

Enter filename: RSXl^M 

VMR>REM MCR... ! remove old MCR 

VMR>INS MCR ! install new MCR 

VMR>"Z 

! 

! end of procedure 
! 

To rebuild the multiuser MCR, use the following procedure: 



DLO: is mounted with RSXM35 baseline disk 

>MOU DL1:EXCPRV 

>SET /UIC=[l,2x] 

>LBR DL1:MCR/RP=SPS0V ! replace object module into MCR.OLB 

>PIP DL1:MCR.0BJ/AP=SPS0V.0BJ » for terminal-driver dependent 

! modules only 
>PIP SPSOV.OBJ;*/DE ! clean up 

invoke SYSGEN3 to build privileged task MCM 

>SET /UIC=[200,200] 

>§SYSGEN3 ! refer to SYSGEN Manual for details 



>ASN DLO:=SY: • ensure proper assignments 

>ASN DLO:=LB: ! for VMR 

>VMR 

Enter filename: RSXllM 

VMR>REM MCR... ! remove old MCR primary 

VMR>REM ...MCR ! remove old MCR secondary 

VMR>INS MCRMU ! install new MCR primary 

VMR>INS SYS I install new MCR secondary 

VMR>~Z 

I 

1 end of procedure 



There is only one procedure for replacing an external MCR task. It 
involves the following steps: 

1. Create the SLP file, apply it, and create the object file. 

2. Incorporate the updated module into the task's object 
library. 

3. Rebuild the task and install it in the system, using MCR or 
VMR. Before using VMR, you must assign SY: and LB: to 
the disk containing the target system. 
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The following example replaces the module INSLB of the external MCR 
task Install: 

>SET /UIC=[1,24] 

>LBR INS/RP= [12,24] INSLB 

If it was necessary to modify the external task's Task Builder 
command file during the last system generation, it may be necessary 
at this time to repeat those changes: 

>SET /UIC=[1,24] 

>ASN SY:=MP: 

>TKB eiNSBLD 

>SET /SYSUIC 

SYSUIC=[g,m] 

>PIP /NV= [ 1,54] INS. TSK 

>VMR 

ENTER FILENAME: RSXllM 

VMR>REM e=.INS 

VMR>INS INS 

VMR>"Z 

>RUN $SHUTUP 

Hardware bootstrap the system. 

The following tables summarize where the relevant MCR files appear 
on the multiple-media distribution kits: 

For RL01/RL02 distribution kit: 



MCRSRC 
EXCPRV 



[12, 10]*. MAC 
[12,10]*. MAC 



All MCR source files 

MCR terminal-driver dependent 
source files 



EXCPRV 



[l,2x]MCR.0LB 
[l,2x]MCR.0BJ 



MCR object library 
Concatenated terminal-driver 
dependent object modules (used 
by SYSGEN) 



RSXM35 



[1,1]EXEMC.MLB Prefix files to assemble MCR 
[11,10]RSXMC.MAC modules 



For RK06/RK07 distribution kits: 



CLISRC 
RSXM35 



[12, 10]*. MAC 
[12,10]*. MAC 



All MCR source files 

MCR terminal-driver 
source files 



dependent 



RSXM35 



RSXM35 



[l,2x]MCR.0LB 
[l,2x]MCR.0BJ 



[1,1]EXEMC.MLB 



MCR object library 
Concatenated terminal-driver 
dependent object modules (used 
by SYSGEN) 

Prefix files to assemble MCR 



[11,10]RSXMC.MAC modules 
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1.4.2.3 Updating a E)CL Source Module - The procedure is different 
for the DCL task. There are two DCL object libraries: DCLR.OLB for 
modules in the root segment of the DCL task, and DCLO.OLB for 
modules in DCL's overlay segments., (One module, COMMAND, has 
versions in both the root and overlay libraries.) These libraries 
are located in UFD [1,24] of your distribution kit. If you are not 
sure whether a module belongs in the root or the overlay library, 
use LBR to scan the module names in the libraries. For instance, to 
view the module names in DCLO.OLB, enter the following command: 

MCR: 

LBR [1,20]DCLO/LI 

DCL: 

LIBRARY/LIST [1,20]DCLO 

The modules you are most likely to need to modify are the DCL syntax 
tables, which are in DCLO.OLB. (All DCL syntax tables are in 
overlay segments.) See Chapter 12 of the RSX-llM/M-PLUS System 
Management Guide for more information on the structure of the DCL 
task and on the DCL task-building process. 

File DCL.CMD, in UFD [23,24] of your distribution kit, can be used 
either to assemble DCL overlay modules and to re- task-build DCL, or 
as a template for your own commands. The file contains its own 
instructions. Note that to use this command directly, you must copy 
various files into its UFD, and you must appropriately modify any 
UFDs that they reference. DCL.CMD also shows how to assemble the 
special module COMMAND. 

The following process shows how to reassemble a DCL overlay module 

and re-task-build DCL. The process is similar for root modules; 

simply specify DCLR rather than DCLO. See DCL.CMD for details on 
rebuilding COMMAND. 

MCR: 

SET /UIC=[23,24] 

MAC XXX= [11 , 10] RSXMC/PA: 1 , [ 23 , 10] DCLMAC/PA: 1 ,XXX 

SET /UIC=[1,20] 

LBR DCLO/RP=[23,24]XXX 

SET /UIC=[1,24] 

TKB §DCLBLD 

DCL: 

SET DEFAULT [23,34] 

MACRO [11 , 10] RSXMC/PASS : 1 , [ 23 , 10 ] DCLMAC/PASS : 1 ,XXX 

SET DEFAULT [1,20] 

LIBRARY/REPLACE DCLO [23,24]XXX 

SET DEFAULT [1,24] 

LINK @DCLBLD 

When you have built a new version of DCL.TSK, you must replace the old 
copy of DCL as a system CLI, as follows: First, any terminals whose 
CLI is DCL must be logged off or set to another CLI. Then the 
following commands must be executed. (Note that these commands are 
MCR only.) 
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MCR: 

CLI /ELIM=DCL 
REM DC L 

INS $DCL/CLI=YES 
CLI /INIT=DCL 



The REMove and INStall commands are also valid VMR commands and can be 
used to modify your system's image on disk. However, the CLI /INIT 
command is MCR only, and must be put in your system's startup file (if 
it is not there already) . 



1.4.3 Patching Object Modules 

The Object Module Patch Utility (PAT) incorporates an object patch 
into an existing object module. DIGITAL publishes a patch file 
written in MACRO-11 assembly language to correct an error or make a 
change. You then create and assemble the published file and input it 
to PAT along with the object file being patched. 

You must include the published checksum values in the specification 
for the input file and the correction files. If the checksum value 
does not agree with the computed result, PAT reports an error. If the 
correction file caused the error, check the source file against the 
original published source file to verify that it was copied correctly. 
If the input file caused the error, verify that the correct version of 
the object file is being patched. 

Note that it normally is necessary to use LBR to extract the original 
object module from a library. PAT produces a new object module file 
containing the corrected object code. When you patch modules from a 
library, take the input object module from the distributed library and 
put the patched object file into a copy of that library. 

The following guidelines apply to the formats for PAT command input 
and correction files. 

Specify an explicit name, extension, and version number for each file. 
Use the following conventions for names: 

File Specification 

Correction file source name. PAT 

Correction file object name.POB 

Input file object name.OBJ;n 

Patched object name.OBJ;n+l 

Specify checksums for all input and correction files. 

The following example illustrates the command formats for updating an 
object module. First you must create the correction source file using 
a text editor, and then do the following: 

>MAC NAME. POB=NAME. PAT 

>LBR NAME.0BJ=LIBRARY.0LB;1/EX:NAME 

>PAT NAME. OBJ ; 2=NAME. OBJ ;1/CS: 3471, NAME. POB/CS: 153 2 

>LBR LIBRARY. 0LB;2/RP=NAME. OBJ; 2 

The correction source input file is used to accumulate all patches for 
a given module. 
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1.5 NOTES TO RSX-llM V4.1 DOCUMENTATION 



The following sections contain notes that correct or supplement the 
V4.1 documentation. 



1.5.1 RSX-llM System Generation and Installation Guide 

In Sections 2.3.1.2 and 2.3.2.1, Copying the Big Disk Magnetic Tape 
Kit Stand-Alone and Copying the Big Disk Magnetic Tape Kit On-Line 
respectively, the procedure BRU uses to copy the big disk 800 bpi 
magnetic tape kit (steps 4 through 7 for Section 2.3.1.2 and step 5 
for Section 2.3.2.1) is not documented in the correct sequence. The 
correct procedure (either stand-alone or on-line) to copy the big disk 
800 bpi magnetic tape kit is as follows: 

1. Invoke the Backup and Restore Utility (BRU) and enter the 
command line to copy the tape to disk. For example, to copy 
the distribution tapes to the RM02 disk, enter the following 
command to BRU: 

>BRU 

BRU>/BAC:RSXM35/INI/REW/DEN:800/VER 
From: MMO: 
To: DRO: 

BRU - Starting Tape 1 on MMO: 

2. BRU copies the first tape and then prompts you for the second 
tape. 

BRU - End of Tape 1 on MMO: 
BRU - Mount Tape 2 on MMO: 
BRU - Starting Tape 2 on MMO: 

3. When the second tape finishes copying, BRU prompts you to 
remount the first tape on the tape drive so that it can do 
the verification of the first tape. 

BRU - End of Tape 2 on MMO: 

BRU - Mount Tape 1 on MMO: 

BRU - Starting verify pass Tape 1 on MMO: 

BRU - End of Tape 1 on MMO: 

4. When BRU finishes verifying the first tape, it is ready to 
verify the second tape. BRU prompts you to remount the 
second tape on the tape drive. 

BRU - Mount Tape 2 on MMO: 

BRU - Starting verify pass Tape 2 on MMO: 

BRU - End of Tape 2 on MMO: 

BRU - Completed 

BRU><CTRL/Z> 

> 

At this point, you have completed the tape-to-disk copy of the big 
disk 800 bpi tape kit and you are ready to generate your RSX-llM 
system. 



1.5.2 RSX-llN/M-PLUS HCR Operations Manual 

The /TERM keyword for the MCR SET command now supports the LA50. You 
should add this new support to page 3-210 of Chapter 3. 
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1.5.3 RSX-llM/M-PLUS Utilities Manual 

1.5.3.1 Correction for PIP Utility - In Chapter 3, page 3-21, the 
maximum vaiue ol tiie oyte ioiion-AUii ui. Jisjc io j i i \\j\,^,aj./ . «^.^ ,^^^^ 
over this will result in an error message. 



1.5.3.2 Correction for FLX Utility - In Chapter 4, Table 4-1, page 5, 
the following correction should be made: 

/IM:n Image Mode The transfer is to be in image mode. 

Image mode forces fixed-length records. 
You can use the value n to indicate the 
desired record length (in octal bytes) for 
Files-11 output (1000 (8) bytes maximum) . 
If you do not specify n, FLX assumes a 
record length of 512 (10) bytes. 

The documentation currently indicates the value of n in decimal rather 
than in octal bytes. 



1.5.3.3 Format Change the LBR /CR switch - In Section 10.5.2 of the 
Librarian Utility Program (LBR) chapter, the format for specifying the 
Create switch (/CR) has changed to the following: 

For macro and object libraries - 

outfile/CR[:size:ept:mnt:inf iletype=infile] 
For universal libraries: 

outf ile/CR[:size:ept:mnt:inf iletype:libtype=inf ile] 



1.5.3.4 New Switch for File Dump Utility (DMP) - In Chapter 11, File 
Dump Utility Program (DMP) , the following new switch should be added 
to Table 11-1. 

Switch Description 

/LIM:n5m Specifies the range of bytes n through m of 

each record or block to be dumped. /OCT is 
still the default if no format switches are 
specified. 



1.5.3.5 New Error Message for PAT Utility - In Chapter 14, Object 
Module Patch Utility (PAT) , the following new error message should be 
added to PAT MESSAGES: 

UNABLE TO OPEN FILE filename 

Explanation: There is insufficient work space in the internal 
File Storage Region (FSR) of the PAT utility. 

User Action: Install or run the PAT utility with an 
increment. 
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1.5.4 RSX-llM/M-PLUS I/O Drivers Reference Manual 

A complete RD51 Fixed Disk/RX50 Flexible Disk Subsystem consists of 
the fixed and flexible disks and an RQDXl hardware controller 
(RQDX1/RD51/RX50) . This information should be included on page 5-4.1. 

Updated I/O error codes for this manual are listed in the RSX-llM 
Mini-Reference. 



1.5.5 IAS/RSX-11 I/O Operations Reference Manual 

1.5.5.1 MTAACP Enhancements - The following sections summarize the 
enhancements made to the RSX-11 V4.0 and V4.1 Magnetic Tape Ancillary 
Control Processor (MTAACP) in compliance with the ANSI standard. 
Detailed descriptions of the enhancements are included in Appendix G 
of the lAS/RSX I/O Operations Reference Manual. 

The RSX-llM V4.0 MTAACP has been enhanced for the following: 

• compliance with ANSI and FIP standards 

• processing of unlabeled tapes 

• Mount, Dismount, and Volume Switch Control 

The RSX-llM V4.1 MTAACP has been enhanced to support RMS V2.0. MTAACP 
supports new file attribute codes (creation, revision, expiration, and 
backup dates) , which read and write the data in the file header using 
a 64-bit date format. MTAACP performs a computation to convert the 
date between ASCII and 64-bit binary form. 



1.5.5.1.1 Compliance With ANSI and FIPS - DIGITAL now provides tape 
labeling systems that conform to ANSI Standard X3.27 — 1978, 
according to the Federal Information Processing Standard. The MTAACP 
has been enhanced to comply fully at levels 1 and 2, and to comply at 
level 3 with the exception of support for user-supplied labels. 
User-supplied labels may appear on a tape; however, they are only 
accessible to application programs through the unlabeled tape 
facility. 

The following new features are a result of the implementation of ANSI 
compliance: 

• Seventeen-character file name support 

If file names appear in quotes ("), they may be up to 17 
characters long and may contain any characters in the ANSI "a" 
character set. 

Note that as a result of this change, PIP directory listings 
of magnetic tapes have a new format. The most noticeable 
difference is the presence of several spaces preceding the 
version number. The spaces are included to clearly delimit 
the version number from the file identifier, which, in 
accordance with the standard, may contain embedded semicolons. 

• Volume Set Identification support 

Previously, the MTAACP only supported Volume Set Identifiers 
that were the same as the Volume Identifier of the first 
volume in the set. However, the ANSI standard requires that 
Volume Identifiers be unique within an installation (thus 
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preventing a user from choosing names of his or her own) . 
Full support of the Volume Set Identifier allows the user to 
choose a name for this field, which becomes the primary means 
of access to a volume using the MOUNT command. This change 
was implemented with full compatibility with the previous 
releases and requires no changes in procedures for users who 
do not wish to use the new feature. 

• Control of attributes 

MOUNT and the MAG utility allow the specification of block and 
record sizes for tapes written on systems that do not write 
this information on the tape. They also allow control of the 
carriage control attribute for tapes created on systems whose 
system code is not recognized by the MTAACP. 

Note that the default block size for files written to tapes 
from an RSX system may also be modified with MOUNT or the MAG 
utility. This value is normally 512 bytes; if it is 
modified, additional buffer space must be allocated in the 
programs writing to tape. 

• Magnetic tape file block size 

The PIP block size switch is no longer necessary when reading 
files from magtape; FCS will adapt automatically to input 
files of varying block size. 

PIP directory listing of files on magtape show the number of 
magtape blocks. Thus, the file size on a magnetic tape 
(represented in terms of variable size blocks) may be 
different from the size of the file on disk. 

• Volume and file accessibility 

In accordance with the ANSI standard, volumes that have a 

nonspace character in the volume accessibility byte may be 

mounted only by a user who has the privilege to override 
accessibility. 

The Initialize Volume Utility allows the specification of the 
character to be placed in the volume accessibility byte in the 
Volume Header Label. 

Also in accordance with the standard, files that have a 
nonspace character in the file accessibility byte may only be 
accessed by a user who has mounted the volume with "override 
accessibility" specified. A user who has mounted a volume in 
this manner may also write a nonspace character in the file 
accessibility byte of the file header label by specifying a 
valid "a" character in the high byte of the file protection 
word and a low byte of all ones. The file protection word may 
be specified at MOUNT time (for example, a file protection 
specification of [,,WED,RWD] represents the character "A") or 
as an attribute to the CREATE QIC. 



1,5.5.1.2 Support of Unlabeled Tapes - The MTAACP now permits tapes 
to be mounted with the /NOLABEL switch. This allows utilities such as 
PIP and higher-level language applications programs (in FORTRAN, for 
example) to read and write unlabeled tapes using the standard READ and 
WRITE statements in the language. 

Files on unlabeled tapes may contain fixed-length records that may be 
blocked or unblocked. 
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In addition, when processing unlabeled tapes, you may request 
character set translation. An EBCDIC translate table is provided with 
the ACP; you may add up to three additional installation-defined 
translate tables. Control of this feature is provided by the MOUNT 
command and by the MAG utility, as well as by attributes specified by 
applications programs when you create files. 

The file name used when you access an unlabeled tape may specify 
positioning information, if desired. If no positioning information is 
desired, the file name has no meaning. However, some utilities, such 
as PIP, may require a dummy file name to prevent the use of wildcard 
mode. 

Note that there are now three ways tapes may be mounted: 

• Mounted for ANSI 

• Mounted for Unlabeled Processing 
e Mounted foreign 

The ability to mount a tape "foreign" is provided for compatibility 
with other operating systems and has no effect in an RSX-llM system 
other than reserving the drive for exclusive use. Access to a tape 
mounted "foreign" is handled by logical QIO directives. Access to a 
tape mounted "unlabeled" (/NOLABEL) or "ANSI" is through virtual QIOs, 
primarily those issued by FCS, RMS, the READ and WRITE statements of 
higher-level languages, and file-oriented utilities such as PIP. 

In order to obtain support for unlabeled tapes, you must select ANSI 
Magtape support at system generation. 



1.5.5.1.3 Mount, Dismount, and Volume Switch Control - When the 
operator dismounts an ANSI tape, the default action recommended in the 
standard is to unload the tape. Depending on which model tape drive 
is in use, this will either take the drive off line or actually unload 
the tape. 

The DCL /[NO]UNLOAD switch and the MCR /LOCK= [NO] UNLOAD switch specify 
a different action to be taken. This switch can be applied to either 
the MOUNT or DISMOUNT command. 

When a volume switch is requested, you may, by using the MAG utility, 
cause error codes to be returned to the program that is reading or 
writing. (Previously, it was necessary either to mount a tape or to 
abort the program.) The MAG utility also allows a tape to be 
initialized if a new tape is needed for output and no previously 
initialized tape is available. 



1.5.5.1.4 RMS-11 Support - MTAACP supports new file attribute codes 
(creation, revision, expiration, and backup dates) , which read and 
write the date in the file header using a 64-bit date format. MTAACP 
performs a computation to convert the date between ASCII and 64-bit 
binary form. 
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1.5.5.2 FDB Offset Definitions - The following information should be 
added to the FDB Offset definitions listed in Appendix A of the 
IAS/RSX-11 I/O Operations Manual ; 



Offset 



F.RATT 



F.NRBD 



F.RCNM 



F.VBN 



Size 
(in Bytes) 



Contents 



Bit 2 = 1 to indicate the "print file 
format" (FD.PRN). FCS allows this 
attribute but does not interpret the 
format word. 

Contains the next record buffer 
descriptor. The format of the record 
buffer descriptor is the size word 
followed by the address of the buffer. 

Contains the number of the record for 
random access operations. The format 
of the record number is the high-order 
word followed by the low-order word. 

Contains the virtual block number. 
The format of the virtual block number 
is the high-order word followed by the 
low-order word. 



1.5.5.3 Shared Access and 

information in Chapter 2, 
Operations Reference Manual: 



face 



actl 



Block Locking - Include the following 
Section 2.2.1.5 of the IAS/RSX-11 I/O 



• FA.SHR - Shared access 
locking. 



is also a precondition for block 



FA.LKLSFA.EXL - FCS permits limited block locking to 
coordinate two or more tasks' access to the same file. All 
tasks accessing the file must open the file for shared access 
by setting bit FA.SHR in FDB field F.FACC (the field access 
byte) . 



1.5.5.4 Opening a File by File ID Number - Include the following 
information in Chapter 3, Section 3.5 of the IAS/RSX-11 I/O Operations 
Reference Manual. This information follows the bulleted list at the 
end of the section: 

The OFID$W macro call is equivalent to the OFID$U macro call; 
invoking either OFID$W or 0FID$U opens an existing file by file ID 
number for update and extension. 



1.5.5.5 Buffer Flush Routine (.FLUSH) - Include the following 
information in Chapter 4 of the IAS/RSX-11 I/O Operations Reference 
Manual as Section 4.17: 
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When using PUT$S to a disk or ANSI tape file, PCS does not normally 
write the contents of the block buffer to a file until the block 
buffer is full or the file is closed. The .FLUSH routine forces the 
block buffer to be written to the file. You may need this function to 
protect data from a system crash or if the data needs to be written so 
that another task can read it from the file. 

The following register must be preset before calling this routine: 

RO Must contain the address of the associated FDB. 

During output, all registers are preserved, the carry bit is clear or 
set to indicate success or failure, and the FDB F.ERR byte contains 
the success or failure code. 



1.5.5.6 I/O Error Codes - Updated I/O error codes for this manual are 
listed in the RSX-llM Mini-Reference. 



1.5.6 IAS/RSX-11 SYSTEM LIBRARY ROUTINES REFERENCE MANUAL 

The following program section names and SYSLIB routines should be 
added to Table 1-1 of the IAS/RSX-11 System Library Routines Reference 
Manual: 



Program 
Section 
Name 

PUR$D 



PUR$I 



SYSLIB Routines 
Module Routine 



Name 

CAT5B 
(data) 

EDTMG 
(data) 

CAT SB 
(instruction) 

EDTMG 

( instruction) 



Name(s) 
$CAT5B 

$ EDTMG 

$CAT5B 

$ EDTMG 



1.5.7 RSX-llM/M-PLUS ODT Reference Manual 

The format for the relocation registers in some sections of this 
manual Is incorrect. The correct format for the registers is $nx, 
where n is a number and x is a letter. The manual, however, 
incorrectly reverses the letter and number, using an $xn format. For 
example, where the text references relocation register $R0, the 
reference should be $0R. 



1.5.8 RSX-llM/M-PLOS Systen Managenent Guide 

1.5.8.1 Virtual Monitor Routine (VMR) - VMR, 
10, now has the following new error messages: 



documented in Chapter 
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• VMR — Saved system truncated to n, blocks 

Explanation: (RSX-llS systems only.) VMR tried to save a 
s"Stern "greater than n» bloc)cs= This results in VMR 
truncating the saved image file to n. (112 decimal 
blocks for 28. K word systems saved on paper tape, 492 
decimal blocks for 123. K word systems saved on RXOl 
floppy diskettes, and 496 decimal blocks for 124. K word 
systems saved on all other bootable devices) . 

• VMR — Reference to memory beyond end of system image file 

Explanation: VMR attempted to fix a task, load a driver, 

or install a common beyond the space limits of the system 

image file. This results in the command aborting and not 
executing. 

The VMR SET /TERM keyword now supports the LA50. 



1.5.9 RSX-llM Guide to Writing an I/O Driver Manual 
1.5.9.1 Changes to Data Structure Macros - Appendix C 



1.5.9.1.1 HWDDF$ - The symbol for the previous mode field of the 
program status word, PMODE, is no longer conditional on memory 
management (M$$MGE) . 

The following symbol has been added to the third feature mask symbol 
definitions: 

F3.SHF=40000 ;MEMORY SHUFFLER SUPPORTED 



1.5.9.1.2 PKTDF$ - In the kernel AST control block definitions, the 
following kernel AST types have been removed: 

AK.TBT=203 ;TASK FORCED T-BIT TRAP AST 

AK.DIO=204 ;DELAYED I/O (M-PLUS COMPATIBLE) 

and the following kernel AST type has been added: 

AK.GGF=303 ;GROUP GLOBAL RUNDOWN AST 

In the Executive pool monitor control flags, the following $POLST 
f lag : 

PC.ALF=4 ;POOL ALLOCATION FAILURE (1=YES) 

has been expanded into two flags: 

PC.ALF=4 ;FAILED TO ALLOCATE LARGE BLOCK (1=YES) 

PC.XAF=10 ;FAILED TO ALLOCATE SMALL BLOCK (1=YES) 

and the following flag has been added: 

PC.XIT=200 ; FORCE POOL MONITOR TASK TO EXIT 
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1.5.9.1.3 TCBDF$ - In the Task Control Block offset definitions, the 
conditional! zation on the group global event flag use count field, 
T.GGF, has been changed from group global event flag support or the 
Send Data directive: 

$$$=. 

T.GGF: .BLKB 1 ;GROUP GLOBAL USE COUNT FOR TASK 

.IF NDF G$$EPN J R$$SND 
.=$$$ 

.ENDC ;G$$EFN ! R$$SND 

to group global event flag support and either the Send Data directive 
or alternate CLI support: 

$$$=. 

T.GGF: .BLKB 1 ;GROUP GLOBAL USE COUNT FOR TASK 

.IF NDF R$$SND & G$$EFN ! A$$CLI & G$$EFN 
.=$$$ 

.ENDC ;R$$SND & G$$EFN ! A$$CLI & G$$EFN 



1.5.9.1.4 OCBDF$ - In the Unit Control Block offset definitions, the 
following MSCP disk driver offsets have been added: 

CHARACTERISTICS STORED FROM "GET COMMAND STATUS" END PACKETS 

000124 U.OTRF=U.VCB+70 ; OUTSTANDING COMMAND STATUS REQUEST REG 
000126 U.CMST=U.VCB+72 /COMMAND STATUS PROGRESS REGISTER 

The console driver offsets have moved from U.CNT to U.BUF+2: 



.=U.BUF+2 

000026 U.CTCB: .BLKW 1 

000030 U.COTQ: .BLKW 2 

000034 U.RED2: .BLKW 1 



ADDRESS OF CONSOLE LOGGER TCB 
I/O PACKET LIST QUEUE 
REDIRECT UCB ADDRESS 



A new terminal-dependent characteristic word bit definition has been 
added: 

i 

; TERMINAL DEPENDENT CHARACTERISTICS WORD 4 (U.CW4) BIT DEFINITIONS 

f 

U4.CR=100 ; LOOK FOR CARRIAGE RETURN 



1.5.9.2 Asynchronous Buffered I/O - The following information on 
buffered input and output should be included in Chapter 2. 

Typically, data for input and output requests are transferred directly 
to and from task memory. To allow the successful transfer of data, 
the task cannot be checkpointed until the transfer is complete. For 
most high-speed devices, the transfer occurs quickly enough so that a 
task does not occupy memory for too long a time. For slow-speed 
devices, however, some mechanism must be available to avoid binding 
memory to a task for too long a time while the task is performing I/O. 

Using the routines $TSTBF, $INIBF, and $QUEBF in the Executive module 
lOSUB, a driver can execute an I/O request for a slow-speed device and 
allow the task to be checkpointed while the request is in progress. 
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To perform the I/O request, the driver buffers the data in memory 
allocated to the driver while the task is checkpointed and the I/O 
request is in progress. 

To test whether a task is in a proper state to initiate I/O buffering, 
the driver calls the $TSTBF routine and passes it the address of the 
I/O packet. By extracting the address of the task control block (TCB) 
from the I/O packet, $TSTBF can examine various task attributes. For 
example, if the task is checkpointable, buffered I/O can be performed. 
$TSTBF returns to the driver and indicates whether buffered I/O can be 
performed. 

If buffered I/O can be performed, the driver performs two operations. 
First, it establishes the buffering conditions. For an output 
request, it copies the task buffers to dynamically allocated pool 
space. For an input request, it allocates sufficient pool space to 
receive the incoming data. Second, the driver calls the $INIBF 
routine to initiate the I/O buffering. $INIBF decrements the task I/O 
count, increments the task's buffered I/O count in T.TIO, and releases 
the task for checkpointing and shuffling. If the task is currently 
blocked, the task state is transformed into a "stopfor" state until 
the task is unblocked, buffered I/O completes, or both. Checkpointing 
the task is subject to the normal requirements of an active or 
"stopfor" state as described in the RSX-llM-PLUS Executive Reference 
Manual. 

After the driver transfers the data, it calls the $QUEBF routine to 
queue the buffered I/O for completion. $QUEBF sets up a KERNEL 
asynchronous system trap (KERNEL AST) for the buffered I/O request 
and, if necessary, unstops the task. When the task is active again, a 
routine in the Executive module SYSXT notices the outstanding AST and 
processes it. (If the request is for input, the routine copies the 
buffered data to task memory.) This mechanism occurs transparently to 
the task; thus the name KERNEL AST. The routine then calls the 
driver to deallocate the buffer from pool. $IOFIN completes the 
processing. These routines are not always present in RSX-llM. If you 
selected the full duplex terminal driver or networking support during 
system generation, they are automatically included. To include them 
in systems without these options, add the symbol A$$BIO= to 
RSXMC.MAC during Phase I of system generation. 



1.5.10 RSX-llM/M-PLUS Task Builder Manual 

1.5.10.1 Task-building an F4PRES, FORRES, or FMSRES with/without 
ECSRES - The following section describes how and why you might want to 
link an application task to one or more languages, FMS, or a FCS 
resident library. Trade-offs or memory, speed, flexibility, and ease 
of use are discussed. For the sake of simplicity, the example of a 
FORTRAN-IV-PLUS OTS resident library (F4PRES) is used in the rest of 
this text to represent FORTRAN-IV-PLUS, FORTRAN-IV (FORRES), and FMS 
(FMSRES) resident libraries. 

On RSX-llM systems, resident libraries must reside in dedicated 
partitions. In general, the presence of a permanent resident library 
is justified when it is used frequently enough that it saves physical 
memory, compared to having the FCS or OTS code in the task images of 
frequently used tasks. For more information on resident libraries, 
refer to the RSX-llM/M-PLUS Task Builder Manual Section 4.5, Use and 
Size of Overlay Run-Time Routines, and Section 5.2, Cluster Libraries. 

In all cases, the application task need only be linked to properly 
built resident libraries usin" the LIBR, COMMON, RESLIB, RESCOM, or 
CLSTR options. 
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1.5.10.1.1 FCSRES - The types of FCS resident libraries are as 
follows: 

1. Memory-resident overlaid FCSRES 

SYSGEN can automatically generate a memory-resident overlaid 
FCS resident library that uses one APR of task address space. 
This FCSRES makes available all of FCS (except little-used 
routines .CTRL, .PRSDI, and .PPR50), .CSIl, .CSI2, and many 
other system library routines. See [1 ,20] FCSRSlBLD.BLD for a 
list of routines. When FCSRES is built from 
LB: tl,l]SYSLIB.OLB, it uses 5128 decimal words of physical 
memory; and when it is built from LBP: [1,1]ANSLIB.0LB, it 
uses 6624 decimal words. FCSRES uses one APR in either case 
because it is composed of two memory-resident overlays and a 
null root segment. 

SYSGEN Phase II and SYSGEN Phase III can link utility tasks 
to this FCSRES, frequently improving task execution speed and 
virtual address space, and lessening task image size. This 
feature, plus the fact that no editing of a source file is 
required, makes the memory-resident FCSRES easier to use than 
the non-memory-resident FCSRES. 

This memory-resident FCSRES obviously requires 
memory-resident support. 

In order to task-build an application task to both the 
memory-resident FCSRES and F4PRES, it is necessary to take 
special measures when building the F4PRES. Such a resident 
library is said to have revectored FCS. Once the F4PRES is 
built, application tasks may be linked to it with or without 
linking to FCSRES as well. The TKB cluster library facility, 
using the CLSTR option, may be used to task-build the 
application task to two or more resident libraries at a 
savings in virtual address space. 

2. Non-Memory-resident FCSRES 

You can manually assemble and build a non-memory-resident 
FCSRES from [200,200] FCSRES. MAC. If you build the resident 
library using LB: [1 , 1] SYSLIB.OLB, you can produce a 3744 
decimal-word, 1-APR FCSRES without editing FCSRES. MAC. If 
you build the resident library using LB: [1 ,1]ANSLIB.0LB, then 
you must edit FCSRES. MAC to remove enough FCS routines from 
FCSRES to bring it below 4K words. Unedited, FCSRES. MAC 
builds into a 2-APR, 4448 decimal-word FCSRES using 
ANSLIB.OLB. 

Unedited, this FCSRES contains all of FCS. Note that .CSIl 
and .CSI2, used by FORTRAN-IV and FORTRAN-IV-PLUS ASSIGN and 
OPEN statements, are not present in the non-memory-resident 
FCSRES. Their 1426 decimal total bytes will be present 
either in your application task images if you use ASSIGN or 
OPEN or they can be included in F4PRES. 

If you want to link RSX utilities to a non-memory-resident 
FCSRES, you must create and edit the TKB .CMD and .DDL files 
and task-build the utilities manually. 

No memory-resident support is required. 
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1.5.10.1.2 F4PRES - Building an optimal F4PRES depends on the 

specific F4P OTS routines your application tasks use, their need for 

virtual address space, and the available physical memory on your 
system. 

You must decide which F4P OTS routines are used frequently enough by 
your applications to warrant their presence in F4PRES. Routines are 
included or excluded by editing F4PRES.MAC. 

The gating factor is often the number of APRs used to map to the 
resident libraries. For example, if you construct an F4PRES that uses 
two APRS, clustered with FCSRES, for a total of two APRs, you might 
have an important privileged application task that only has 1 APR 
available. In this case, it may be best to edit more routines out of 
F4PRES, to trim it to 1 APR. 

The key to building an F4PRES so that it can be used with the 
memory-resident FCSRES is, that no PCS code is present in the F4PRES, 
but all subroutine calls to FCS in the F4PRES are resolved when the 
F4PRES is built. This scheme involves revectoring the FCS calls 
through the application task image. The scheme is described in detail 
(including TKB command files) in the RSX-llM/M-PLUS Task Builder 
Manual, Section 5.2. 



1.5.10.1.3 Options and Tradeoffs - There are a number of ways of 
building application tasks with resident libraries. 

The following examples assume a minimally sized F4PRES: 4096 
decimal words (1 APR) if FCS is not contained in it, and 8192 
decimal words (2 APRs) if FCS is contained in it. These numbers will 
vary according to the F4P OTS routines that you include in F4PRES. It 
may not be possible for you to construct a useful F4PRES of one or 
both of these sizes; yours may have to be two APRs or three APRs, 
respectively. 

In the following cases, the "Virtual and Physical Memory" discussions 
are always relative to a task with no overlays or resident libraries. 
Your own disk or memory-resident overlays may add overlay run-time 
routines, autoload vectors, and segment and region descriptors to your 
task. Section 4.5 discusses this in more detail. 

• Case 1 

F4PRES with revectored FCS calls and memory-resident FCSRES 
used as a cluster library. Link the application task with 
this TKB option: 

CLSTR=F4PRES, FCSRES :R0 

Uses a total of one APR, making available maximal virtual 
address space in the application task. This is most 
appropriate for tasks that can take advantage of the increased 
virtual address space. On a system with the memory-resident 
FCSRES, F4P application tasks that do not profit from the 
increased address space should be built according to case 2, 
with two LIBR= TKB options. Macro application tasks, of 
course, can be built with one LIBR=FCSRES:RO TKB option (see 
case 3 for memory characteristics in this case) . 

If FCS routines are called from the task image, the calls are 
resolved to entry points in FCSRES. (FCS routines might be 

subroutines.) 
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Virtual and physical memory: Uses one APR. The application 
task root incurs a load of 1250 decimal bytes, 32 decimal from 
FCSJMP.OBJ, 650 decimal from FCSRES.STB (autoload vectors, 
segment and region descriptors) , and 568 decimal from the 
overlay run-time routines. 

Execution speed: Some execution time is consumed when the 
overlay run-time code in the task image must change the APRs 
from one resident library to another. 

Case 2 

F4PRES with revectored PCS calls and memory-resident FCSRES, 
though not used as a cluster library. Link the application 
task with these TKB options: 

LIBR=FCSRES:RO LIBR=F4PRES:R0 

Uses a total of two APRs for the resident libraries, but there 
is less overhead than with a cluster. This is best for tasks 
that cannot profit by using the extra APR that a cluster could 
make available. If FCSRES is predominantly being used in this 
way (little use of FCSRES linked to RSX utilities or macro 
application tasks, and no clustered FCSRES and F4PRES) , then 
you should also consider case 4, where a 2- APR F4PRES 
contains FCS with no cost in autoload vectors, FCSJMP, or 
overlay run-time routines for FCSRES. Other tasks can 
reference the resident libraries with one or more TKB LIBR 
options, or with CLSTR. 

If FCS routines are called from the task image, the calls are 
resolved to entry points in FCSRES. (FCS routines might be 
called by either the OTS code in the task image or your macro 
subroutines.) 

Virtual and physical memory: Uses two APRs. The application 
task root incurs a load of 1164 decimal bytes, 32 decimal from 
FCSJMP.OBJ, 650 decimal from FCSRES.STB (autoload vectors, 
segment and region descriptors) , and 482 decimal from the 
overlay run-time routines. 

Execution speed: Some execution time is consumed when the 

overlay run-time code in the task image must change the 

mapping of the FCSRES 's APR from one overlay to another, but 
less time is used than with a cluster. 

Case 3 

Link to the memory-resident FCSRES and have the OTS code 
present in your task image. Link the application task with 
this TKB option: 

LIBR=FCSRES:RO 

This is appropriate when FCSRES is necessary, but you cannot 
justify having a permanent F4PRES on your system. 

Virtual and physical memory characteristics: one APR is used 
for FCSRES. The OTS code is included in the application task 
image, likely thousands of bytes. (This may need to be 
overlaid.) The task root also incurs a load of 1132 decimal 
bytes: 650 decimal from FCSRES.STB (autoload vectors, segment 
and region descriptors) , and 482 decimal from the overlay 
run-time routines. 
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Execution speed: Some execution time is consumed when the 
overlay run-time code in the task image must change the 
mapping of resident libraries' APRs from one library to 
another. More execution time is used if you overlay the OTS 
code in the task image. 

• Case 4 

Link to F4PRES with revectored FCS, so that FCS code is 
present in your task image. This combination is never the 
best choice because F4PRES and your application tasks will 
include FCSJMP and FCSVEC with no benefit. However, tasks 
will link and execute correctly. Link the application task 
with this TKB option: 

LIBR=F4PRES:R0 

• Case 5 

Link to an F4PRES containing FCS. Link the application task 
with this TKB option: 

LIBR=F4PRES:R0 

This is appropriate when F4PRES is necessary; you do not need 
a permanent FCSRES on your system, and no critical application 
tasks would profit from the increased address space of a 
clustered FCSRES and F4PRES. 

This combination tends to contain more OTS code in the same 
number of APRs than case 6 because only the FCS used by F4PRES 
is present, leaving more room for OTS code. 

If your task contains macro subroutines that use FCS, try to 
use the FCS routines already contained in F4PRES, like OFNB$, 
OFID$,or DELET$. Otherwise, the task will contain large 
amounts of FCS code. 

Virtual and physical memory characteristics: two APRs are 
used. There is no overlay overhead due to the resident 
library. 

Execution speed: There is no overlay overhead due to the 
resident library. 

• Case 6 

Link F4PRES to a non-memory-resident FCSRES (LIBR=FCSRES:RO in 
the F4PRES TKB command file). Link the application task to 
F4PRES with this TKB option: 

LIBR=P4PRES:R0 

If you have a non-memory-resident FCSRES on your system, this 
may be appropriate. Note that case 5 tends to include more 
OTS code in the same number of APRS. 

If FCS routines are called from the task image, a space 
problem can occur. (FCS routines might be called by either 
OTS code in the task image, or your macro subroutines.) FCSRES 
entry points are available only to a task or resident library 
linked directly to FCSRES; they are not available to a task 
linked to F4PRES in this case. Thus, any FCS routine called 
in your task will bring a number of FCS modules into the task 
image. 
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Virtual and physical memory characteristics: two APRs are 
used. There is no overlay overhead due to the resident 
library. 

Execution speed: There is no overlay overhead due to the 
resident library. 

Case 7 

Link to a non-memory-resident FCSRES and have the OTS code 
present in your task image. Link the application task with 
this TKB option: 

LIBR=FCSRES:RO 

This is appropriate when the non-memory-resident FCSRES is 
necessary, but you cannot justify having a permanent F4PRES on 
your system. 

Virtual and physical memory characteristics: one APR is used 
for FCSRES. The OTS code is included in the application task 
image, likely thousands of bytes. (This may need to be 
overlaid.) 

Execution speed: There .is no overlay overhead due to the 
resident library. 



1.5.11 RSX-llM/M-PLUS Executive Reference Manual 

1.5.11.1 Change to Executive Directives - For the Attach Region 
(ATRG$) and Create Region (CRRG$)directives, the Executive will return 
the directive error status lE.PNS if the region specified in the 
directive is not a common or if the common is not installed. 



1.5.11.2 Corrections to Executive Reference Manual - The following 
changes should be made to the RSX-llM/M-PLUS Executive Reference 
Manual . All the changes apply to Chapter 5. 

• On page 5-7, the first sentence under "Macro Expansion:" 
should read "Most of the directive descriptions expand the $ 
form of the macro." 

• ALTP$ 

On page 5-11, add the following return code and definition to 
the list of DSW return codes: 

lE.RSU — Resource (the task's header) unavailable because 
task is checkpointed with outstanding I/O. 



CINT$ 



On page 5-18, add the following text to the last 
paragraph: 

However, be aware that including the symbol definition 
file can cause references to system subroutines to be 
resolved from that file instead of from the system 
library. To avoid this problem, explicitly include the 
required library modules before specifying the 
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Executive symbol definition file. Specify the /SS 
switch with the file so the Task Builder will resolve 
any symbols that are still undefined. (Specifying the 
/SS switch prevents the Task Builder from trying to use 
multiply defined symbols.) 

2. For corrections to the CINT$ example, beginning on page 
5-25, see the June 1980 issue of the Software Dispatch, 
Sequence 7.1.1.1 N, pages 79 through 84. 

GCCI$ 

On page 5-76, the Command Buffer Format list should be in the 
following order: 

G.CCDV — ... 

G.CCUN — Octal unit number of issuing terminal (1) 

G.CCCT — Number of characters (1) 

G.CCCL — ... 

G.CCTC — Terminator (1) 

G.CCFL — Flags (1) 



G • CCBF — • • • 

GCII$ 

On page 5-80, add the following Local Symbol Definitions: 

G.CIBF — Buffer address 
G.CIBL — Buffer length 
G.CICN — Radix-50 CLI name 
G.CIDV — ASCII terminal name 
G.CIUN — Terminal unit number 

QIOW$ 

On page 5-116, the parameter efn (event flag number) is 
mandatory in the FORTRAN call. 

RDAF$ 

On page 5-125, the Macro Call should define buf as the address 
of a 4-word buffer. 

RPOI$ 

1. On pages 5-130 and 5-131, the second paragraph in the 
definitions of itask and task should be changed to the 
following : 

On RSX-llM-PLUS systems, any task may specify a new 
name for the requested task as long as the requested 
task is not a CLI task. 

For both systems, the requested (specified in the tname 
parameter) task must be installed in the ...tsk format. 

2. On page 5-131, in the Macro Expansion, the line 

.ASCII /dev/ ; ASCII NAME OF TI: OF REQUESTED TASK 
should be the last line in the expansion. 
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• RUN$ 

On pages 5-140 and 5-141, the smg parameter in the FORTRAN 
Call and the Macro Call is mandatory. 

• SCLI$ 

On page 5-148, in the Macro Expansion, the line 

.RAD50 /cli/ ;CLI NAME 
should be the last line in the expansion. 

• SDAT$ 

On page 5-150, the text of the NOTE should be replaced with 
the following text: 

When a local event flag is specified, the flag is set for 
the sending task. When a common event flag is specified, 
the flag is set for all tasks. When a group-global event 
flag is specified, the flag is set for all tasks within 
the specified group. For all event flags, a significant 
event is always declared. 

• SDRC$ 

On page 5-153, in the Macro Expansion, change the line 

.BYTE 2 ; EVENT FLAG NUMBER = 2 
to 

.WORD 2 ... 
and delete the line 

.BYTE 16. ;EXIT STATUS BLOCK CONSTANT 

• SMSG$ 

1. On page 5-163, in the Macro Expansion, change the 
following lines: 

Change SMSG$ SM.ERR ... to SMSG$ SM.SER . . . 
Change .BYTE DIC,8. ... to .BYTE 171,8. . . . 
Change .WORD SM.ERR ... to .WORD SM.SER 



• • • 



and delete from the list of Local Symbol Definitions the 
1 ine 

S.MERR — Error Log Target Identifier 

2. On page 5-164, change the definition of lE.ULN to 
"Specified LUN is not assigned to a mass storage device." 



• STIM$ 



On page 5-196, in the list of offsets, S.TICS should be 
S.TISC. 



1-64 



CHAPTER 2 

RMS-11 VERSION 2.0 RELEASE NOTES 



CHAPTER 2 
RMS-11 VERSION 2.0 RELEASE NOTES 

2.1 NEW FEATURES FOR RMS-11 VERSION 2.0 

The following new features appear in the RMS-11 V2.0 access methods. 

2.1.1 Support for Clustering and Task Independence 

The memory-resident library RMSRES can be clustered with any other 
resident library that supports clustering; this capability allows 
RMS-11 to share task virtual memory with other libraries. See your 
FMS-11 and language documentation to determine whether a particular 
library supports clustering. 

Task-independence means that once a program is linked with RMSRES, the 
library can be rebuilt or replaced without requiring that the task 
linked to it be rebuilt. 

Linking with RMSRES requires use of the RMSRLX.ODL file. Include the 
element RMSROT in the .ROOT statement of your ODL file, and the 
indirect reference @LB: [1,1]RMSRLX in your ODL file. If you used 
RMSRLX.ODL in this manner with VI. 8, no change should be required (if 
you made reference to the RMSALL factor, this is no longer necessary 
but will do no harm) . 

To use this library as a cluster library, you simply specify the CLSTR 
option when linking the task. 



2.1.2 Subset Library Support 

Two versions of the RMS-11 resident library are provided. RMSRES is a 
full-function library that supports all file organizations. 
RMSRESSUB.TSK is a subset library that supports access to only 
sequential and relative file organizations. (Attempts to access 
indexed files using this library will result in the error code 
ER$ENV.) 



2.1.3 Disk-Overlaid RMS-11 

New versions of the RMS-11 VI. 8 ODL files are provided on the 
distribution kit. These ODL files are: 

• RMSllS.ODL 

Designed to use minimal virtual address space for support of 
sequential and relative file organizations, this ODL file adds 
about 6.5KB to the task size. 
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• RMSllX.ODL 

Designed to use minimal virtual address space for full support 
of all file organizations, this ODL file is structured to add 
about 10KB to the task size. 

• RMS12X.0DL 

This ODL file adds about 12KB to the task size, supports all 
file organizations, and offers a good compromise between 
performance for record operations on indexed files and use of 
task virtual address space. 

• RMSll.ODL. 

This is a prototype ODL file that you can tailor to your own 
needs. 

The VI. 8 ODL files will still work with RMS-11 V2.0 but the new 

versions of the ODL files will be more efficient, generally requiring 

less memory and less disk space for the task image. For more 
information on VI. 8 comparisons, see Section 2.3. 

In addition, two new ODL files are provided with V2.0: 

• RMS12S.0DL 

Supporting only sequential and relative file organizations, 
this ODL file adds about 9KB to the task size and is designed 
to offer a good compromise between performance and use of task 
virtual address space. 

• DAPllX.ODL 

Structured to add about 14KB to the task size, this ODL file 
is designed to use minimal virtual address space for support 
of all file organizations and (on systems with the required 
DECnet support) remote access facilities. 



2.1.4 Remote File and Record Access via DECnet 

If suitable DECnet facilities exist on your system and on the target 
system, RMS-11 V2.0 will allow file and record access to files 
residing on other network nodes, provided that such nodes include an 
RMS-11-based file access listener (FAL) . 

For most purposes, remote access is indistinguishable from local 
access, although performance may not be equivalent. The following 
general limitations apply; 

• RMS-11 generally does not support remote functions that are 
not supported locally. 

• Certain RMS-11 functions (wildcard support, PARSE, SEARCH, 
ENTER, REMOVE, RENAME, and transmission of device, directory, 
and file identifiers) are not supported by the data access 
protocol (DAP) used, and hence cannot be executed remotely, 

• Certain FALs do not support the full set of RMS-11 functions 
expressible via DAP, and hence further limit remote access. 
For example, the current RSTS/E RMS-11 FAL does not support 
record access to indexed files. 
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• High-level languages may not allow expression of the file 
specification necessary to establish contact with a remote 
node. 

To operate upon a remote file, your program must include a node 
specification for the remote file and you must include the RMS-11 
remote access code when you build your task. 



2.1.4.1 Remote Node Specification - You must include a remote node 
specification at the start of the file name string or the default name 
string you provide to an OPEN, CREATE, or ERASE operation. In 
addition, your file name string and default name string must conform 
to the DIGITAL Command Language (DCL) file specification syntax rules, 
and the file specification resulting from the merging of these two 
strings must conform to the file specification conventions on the 
destination system as well. 

In general, a file specification consists of the following elements 
(in the order and with the delimiters shown): 

node: ;device: [directory] filename. type; version 

where the elements beyond the node specification conform to the 
conventions of the target system. Elements not present will be 
defaulted according to the conventions of the target system. 

The node element is of the form: 

node"user password":: 

where node is the (required) destination node name and "user password" 
is an (optional) access control string containing login information 
acceptable to the remote system. 

If "user password" is provided, the device and directory defaults and 
access privileges of that remote account are acquired; if not, the 
device and directory defaults and access privileges of the default 
DECnet account on the remote system are acquired. 



2.1.4.2 Linking Programs with RMSDAP Support - To link your program 
with remote RMSDAP modules, you can either use the disk-overlaid 
version or reference the DAPRES resident library: 

• To link with the disk-overlaid version, reference the 
DAPllX.ODL file in your ODL file. As with other RMS-11 ODL 
files, you reference the RMS-11 root modules as RMSROT, and 
specify other RMS-11 modules as the cotree RMSALL. 

• To link with the DAPRES resident library, use the ODL file 
DAPRLX, and specify RMSRES and DAPRES in your TKB command 
file. RMSRES and DAPRES can be specified as single resident 
libraries or as clustered resident libraries. 

Note that DAPRES is a clusterable, task- independent library as defined 
previously for RMSRES. 
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2.1.4.3 RMSDAP Environments - RMS-11-based FALs are currently 
available on VAX/VMS, RSTS/E, RSX-llM, and RSX-llM-PLUS systems. The 
version of data access protocol that is used must be Version 5.6 or 
later; this means that you must have at least Version 2.0 of 
DECnet/E, Version 3.1 of DECnet for RSX-llM, Version 1.1 of DECnet for 
RSX-llM-PLUS, or Version 2.0 of DECnet/VAX. 

For more information on remote access using RMS-11, see Appendix B of 
the RSX-llM/M-PLUS RMS-11 User's Guide. 



2.1.5 Mew File and Directory Operations 

RMS-11 V2.0 supports several new file and directory operations. 



2.1.5.1 ENTER/REMOVE - Your program can use the ENTER operation to 
create a directory entry for a file. You can delete the directory 
entry for a file by using the REMOVE operation; this operation does 
not affect either the existence of the file or the file contents. 



2.1.5.2 RENAME - RENAME is a new RMS-11 operation that can be used to 
replace the directory entry for a file (that is, change the name of a 
file) . The file specification for the new directory entry must not 
specify a new device or node for the file, but can specify a different 
directory, file name, file type, and file version. 



2.1.5.3 PARSE - PARSE is a new RMS-11 operation that can be used to 
analyze a file specification. 

The PARSE operation merges the file specification with the default 
file specification and with the system defaults, and analyzes the 
result. If you specify wildcarding, the PARSE operation constructs a 
match-pattern; this match-pattern can be used by later wildcard 
SEARCH operations. 



2.1.5.4 SEARCH - SEARCH is a new RMS-11 operation that can be used to 
find the next (or first) file that matches a match-pattern 
(constructed as the expanded string by a previous PARSE operation) . 



2.1.6 Wildcarding 

You specify wildcarding by including wildcard characters in the file 
specification (or the default file specification). Wildcards can be 
specified in the directory entry, file name, type, and version. 

See the RSX-llM/M-PLUS RMS-11 Macro Programmer's Guide for a full 
explanation of how to use the new directory operations and 
wildcarding. You may also want to examine the demonstration programs 
that are provided. 
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2.1.7 Random Access to Fixed-Format Disk Sequential Files 

For disk sequential files with records of fixed format, random access 
for GET, FIND, and PUT operations can be specified. This kind of 
random access is very similar to random access to relative files, with 
some exceptions. 

Your program specifies key access by setting the RB$KEY code in the 
1-byte RAC field of the RAB, and by specifying the address of a 
"relative record number" in the KEF field of the RAB. Key size must 
be specified as 4 in the KSZ field of the RAB. 

Some differences from relative file handling are the following: 

• There is no initialization of the space in the file. If the 
first operation is a random PUT to the file at relative record 
number 5, the "cells" preceding record number 5 may contain 
"garbage": that is, whatever data happened to be there. 

(This is similar to VAX-11 RMS.) 

• There is also no maximum record number (except as limited by 
the 4-byte specification of the key). If your program 
specifies a random PUT operation at relative record number 
999, the file will be extended to the appropriate size (but 
not initialized) . 

• A PUT operation overwrites any existing record in the target 
location. 

• There is no support for DELETE operations to a sequential 
file. 



2.1.8 Increased Device Independence 

Files with stream and VFC record formats can now be created on 
unit-record devices to avoid the need for special-case code in 
copy-type operations. 

• In the case of VFC files, the record header is thrown away on 
output unless it is a "print format" file, which RMS-11 now 
supports as VAX-11 RMS does. 

• For stream files, if none of the 3 carriage control bits is 
set (print format, carriage control, or FORTRAN carriage 
control), and if the last character is not a line feed, form 
feed, or vertical tab, then carriage-return/line feed (CR/LF) 
is appended at the end of the record. 

• For stream files, where either the carriage control or FORTRAN 
carriage control attribute is set, if the last two characters 
of the record are CR/LF, the trailing CR/LF is stripped off, 
and then definition of the carriage control (CR or FTN) 
attribute is applied. 

For similar ease- of- copying reasons, RMS-11 now allows creation of 
relative and indexed files for output to nondisk devices (although for 
magnetic tape, record format must be variable length or fixed length). 
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2.1.9 More Usable Block I/O Facilities 

The following enhancements have been made for block I/O: 

• Block I/O can now be used to copy files without the need to 
"fix up" the file header attributes. 

Block I/O READ operations now generally respect the logical 
EOF header attribute (exceptions are documented in the 
RSX-llM/M-PLUS RMS-11 User's Guide and in the RSX-llM/M-PLUS 
RMS-11 Macro Programmer's Guide ) . 

• Block I/O can also be used for sequential access, by zeroing 
the RAB BKT field, allowing sequential copy and update 
operations. 



• 



Extends are now performed automatically, when necessary, 
during block I/O access. The only exception is for sequential 
files that are accessed write-shared. In this case, automatic 
extends are not allowed because there is no mechanism for 
coordinating the updating of the file header attributes. 



2.1.10 Sharing for Relative and Indexed Files 

For increased symmetry, flexibility, and compatibility with VAX-11 

RMS, RMS-11 V2.0 incorporates a change to previous file sharing 
semantics for relative and indexed files on RSX-llM/M-PLUS systems. 

This change affects only write-accessors who specify read sharing (the 

default) for record access to a relative or indexed file. Although it 

is largely transparent in functional terms, in some cases it will have 
a noticeable effect upon the performance of the writer. 

In previous versions of RMS-11, the performance of the writer was 
dependent upon whether any write-sharing read-only accessors were 
already present when the writer requested access: 

1. If such a reader was present, the writer obtained shared 
access to the file, although additional writers were 
prohibited. RMS-11 internal algorithms did not allow the 
writer to "cache" buckets unless the bucket remained locked; 
this limitation affected performance for certain types of 
operations. 

2. If no such reader was present, the writer obtained exclusive 
access to the file. No subsequent RMS-11 readers could 
obtain access, regardless of their sharing specifications. 
RMS-11 internal algorithms allowed this writer to cache 
buckets when possible, thus improving performance by reducing 
disk I/O. 

RMS-11 V2.0 has been changed to eliminate this access-order 
dependency: 

1. When a write-accessor specifies read-sharing (the default) , 
shared access is always granted as described in (1) above. 
Subsequent write-sharing readers can obtain access even if 
the writer was the first to access the file. 

2. A writer desiring the performance advantages of exclusive 
access can specify "no sharing" (new for RMS-11 V2.0) , in 
which case access is granted as described in (2) above. 



2-6 



RMS-11 VERSION 2.0 RELEASE NOTES 

The performance difference between case 1 and case 2 will be most 
evident for sequential PUT operations to a relative file with multiple 
records in each bucket, or for sequential GET/UPDATE sequences to _ a 
relative file with multiple records per bucket or to an indexed file 
by primary key. If extra RMS-11 internal buffers are provided to 
improve performance, they will be ineffective for a writer unless "no 
sharing" is specified. 



2.1.11 RMS-11 Utilities 

2.1.11.1 New File Design Utility - The RMS-11 File Design Utility 
(RMSDES) is a new utility that allows you to interactively design and 
create files. RMSDES supersedes the RMS-11 File Definition Utility 
(RMSDEF) . 

Some of the features of RMSDES are as follows: 

• Full RMS-11 file structure capabilities — You can design and 
create any type of RMS-11 file to contain your data records, 
tailoring it to meet your program's data processing 
requirements exactly. 

• Error detection — RMSDES can detect many kinds of errors and 
omissions in the attribute information you supply. Because 
RMSDES is interactive, you can correct the errors immediately, 
before you create and load records into the file. 

• Saved file description — You can save a description of a file 
design for future use, whether or not you have created a file 
based on the description. This is useful if you want to 
complete an unfinished file design at a later date, or modify 
a file design to accommodate a new use. 

• Copied file description — RMSDES can construct a file 
description based on the attributes of an existing data file. 
You can either create a new file like the existing file, or 
modify the file design before creating a new file. 

• Default calculations — RMSDES can calculate defaults for many 
attributes. 

• Extensive help facilities are provided for RMSDES. 



2.1.11.2 New Features for RMSDSP - RMSDSP has a completely 
reorganized and much more readable format. It also includes the 
following new features: 

• The combination of options /BP/FU now displays more complete 
information about the contents of backup container files. 

• The size field lists high block as well. 

• The protection information is "decomposed" into system, owner, 
group, and world protection fields. 

• RMSDSP lists the file owner. 
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2.1.11.3 New Features for RMSCNV - RMSCNV has been rewritten and is 
smaller and generally faster than the 1.8 version. It has the 
following new features: 

• The /CA switch can be used to dynamically create an output 
file, by copying file attributes from another file. (That is, 
you do not need to run RMSDBS or RMSDEF to create the output 
file before doing the conversion if you already have a 
prototype file whose attributes can be copied for the output 
file.) 

• The /IM switch can be used to copy files in image (block) 
mode. 

• The /EC switch can be used to change ASCII stream files that 
end with a CTRL/Z character to end with null characters. This 
switch is provided for help in converting certain non-RMS-11 
stream files into a format readable by RMS-11 V2.0. (See also 
Section 2.3.6, Other RMS-11 Version 1.8 Compatibility Notes.) 

• The /KNrkeyname switch can be used to convert files based on a 
key name (as opposed to a key number, as in the /KR switch). 

• The /ML switch allows you to explicitly set the limit of 
memory allocation. 

• The /SL switch, summary listing, has been significantly 
enhanced. It now produces several summaries: summaries of 
options used for the conversion, summaries of the file 
attributes for the files involved in the conversion, a message 
summary of errors and warnings, and a processing summary. 

• Remote access capability is provided for suitable 
configurations. Your system and the target system must 
include DECnet support (at least V2.0 of DECnet/E) . The 
target system must also include an RMS-11-based file access 
listener (FAL) , and you must rebuild RMSCNV to include the 
remote access capability (see Section 2.8.3, Utility 
Configurations) . 



2.1.11.4 Additional Utility Features - 

• RMSIFL has been rewritten and incorporates a number of bug 
fixes. 

In addition, the algorithms for allocating work file space for 
sorting have been changed; in most cases, the amount of space 
needed for the sort should be decreased. 

The /DE switch has been enhanced to allow specification of a 
different device for RMSIFL's temporary files. 

• Command and ODL files are provided for rebuilding the RMS-11 
utilities to use different forms of the RMS-11 access methods. 
See Section 2.8.3, Utility Configurations. 

• All utilities now use lowercase format for messages and 
displays. 

• The error message format has been changed for all utilities 
except RMSDEF and RMSIFL. 
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2.2 SUMMARIES OF TECHNICAL CHANGES 

The following sections summarize the new software features for RMS-11. 
The summaries of technical chan'^es also appear in the front matter of 
each manual. 

The title of each manual is followed by a letter indicating whether 
the manual is a new (N) or revised (R) version. 

In addition to the new and revised manuals listed in the following 
sections, the RMS-11 V2.0 documentation set includes a new manual , 
RSX-llM/M-PLUS RMS-11 ; An Introduction , which introduces RMS-11 
concepts, terminology, and operations. The RSX-llM Mini-Reference 
also contains a new section on RMS-11 utilities and error codes. 



NOTE 

All new RMS-11 features are fully 
accessible only to MACRO-11 programmers. 
See your high-level language 
documentation for supported features. 



2.2.1 RSX-llM/M-PLUS RMS-11 User's Guide (R) 

This revision of the RSX-llM/M-PLUS RMS-11 User's Guide documents the 
following technical changes: 

• RMS-11 Version 2.0 supports random access to fixed-format disk 
sequential files and sequential block access to disk files of 
any format and organization. 

• The RMS-11 Version 2.0 resident libraries are task 
independent. This means that once a program is linked with 
this library, the library can be rebuilt or replaced without 
requiring that the task linked to it be rebuilt. 

• RMS-11 Version 2.0 contains no library equivalent to the 
RMSSEQ memory-resident library included with RMS-11 Version 
1.8. The RMSRES resident library or the disk-resident ODL 
files can be used to obtain equivalent functionality and 
performance. 

• New versions of the RMS-11 Version 1.8 ODL files are provided. 
These ODL files are RMSllS.ODL, RMSllX.ODL, RMS12X.0DL, and 
RMSll.ODL. The Version 1.8 ODL files will still work with 
Version 2.0, but the new versions will be more efficient. 
RMS-11 VI. 8 ODL structures other than RMSllS.ODL, RMSllX.ODL, 
and RMS12X.0DL may not work correctly with the RMS-11 V2.0 
code; when in doubt, verify them by comparison with the V2.0 
RMSll.ODL file. In addition, two new ODL files are provided 
with Version 2.0: RMS12S.0DL and DAPllX.ODL. 

• Files with stream and VFC records can now be created on 
unit-record devices to avoid the need for special-case code in 
copy-type operations. 

For VFC files, the record header is thrown away on output 
unless the file is a "print format" file. 
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For stream files, if none of the 3 carriage control bits is 
set (print format, carriage control, or FORTRAN carriage 
control), and if the last character is not a linefeed, 
formfeed, or vertical tab, the carriage-return/linefeed 
(CR/LF) is appended at the end of the record. 

For stream files, if either the carriage control or FORTRAN 
carriage control attribute is set, and if the last 2 
characters of the record are CR/LF, the trailing CR/LF is 
stripped off and then definition of the carriage control 
attribute (CR or FTN) is applied. 

• For similar ease-of-copying reasons, RMS-11 now allows 
creation of relative and indexed files for output to nondisk 
devices (for magnetic tape, however, the record format must be 
variable length or fixed length) . 

• The RMS-11 File Design Utility (RMSDES) is a new utility that 
allows you to design and create files interactively. It is 
fully documented in the RSX-llM/M-PLUS RMS-11 Utilities 
manual. 

• RMS-11 Version 2.0 supports five new directory operations: 
ENTER, PARSE, REMOVE, RENAME, and SEARCH. These operations 
are fully documented in the RSX-llM/M-PLUS RMS-11 Macro 
Programmer's Guide . 

• RMS-11 Version 2.0 supports a new wildcard file specification 
facility and a new print-record output handling format. These 
are also fully documented in the macro programmer's guide. 

• User-provided interlocks allow a special, limited form of 
sequential file sharing among a group of accessors that 
includes at most one read/write accessor and any number of 
read-only accessors. 

• If suitable DECnet facilities exist on your system and on the 
target system, RMS-11 Version 2.0 will allow file and record 
access to files on remote network nodes, if those nodes 
include an RMS-11-based file access listener (FAL) . 

• For magnetic tape, RMS-11 now allows fixed-format records to 
be less than 18 bytes. 

e Files with stream or VFC records can now be created on 
unit-record devices. In addition, RMS-11 now allows the 
creation of relative and indexed files for output to nondisk 
devices, although they will be treated as sequential files. 

• <CTRL/Z> and <ESC> are no longer recognized as record 
terminators for stream files, and <CTRL/Z> is no longer 
recognized as a file terminator for stream files. 

• RMS-11 Version 2.0 pads stream files with null characters, to 
the high block of the file (not just to the end of the current 
block) . 

• The memory-resident library RMSRES can be clustered with any 
other resident library that supports clustering. 

• An optional subset library, containing support for sequential 
and relative files only, is available. 
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2.2.2 RSX-llM/M-PLUS RMS-11 Macro Programmer's Guide (R) 

This revision of the RSX-llM/M-PLUS RMS-11 Macro Programmer's Guide 
uocuments the i.oj.xOwing tcCiinica-L Ciian^es* 

• The new operation macros $ENTER, $PARSE, $REMOVE, $RENAME, 
and $SEARCH are documented, along with the related NAM block 
fields FNB, RSA, RSL, and RSS. 

• The new facility for wildcard file specification is 
documented. 

• The extension of access sharing is documented, along with the 
related masks FB$UPI and FB$NIL for the SHR field of the FAB. 

• Random access to a sequential file with fixed-length records 
(similar to random access to a relative file) is documented. 

• The new print- format record-output handling is documented, 
along with the related symbol FB$PRN for the RAT field of the 
FAB. 

• The new sequential block access is documented; the previous 
block access (formerly called block I/O) is now called VBN 
access (virtual block number access) . 

• Block access can now be used to copy RMS-11 files without the 
need to modify the file's attributes manually. 

• The addition of the success handler facility for file 
operation macros ($CLOSE, $CREATE, $DISPLAY, $ERASE, $EXTEND, 
and $OPEN) is documented. 

• Increased device transparency for record access copy 
operations is supported. VFC and stream record formats are 
supported on unit-record devices. Relative and Indexed files 
can be created for record access on nondisk devices, although 
they will appear as and be processed as sequential files 
there. 

• The obsolete RMS-11 initialization macros $INIT and $INITIF 
are no longer documented. These macros are now defined as 
no-ops in the RMS-11 macro library RMSMAC.MLB; their 
previous functions are no longer needed because RMS-11 is now 
self-initializing. However, programs that use the $INIT and 
$INITIF macros in their previous senses remain valid under 
RMS-11 Version 2.0. 

• Each XAB type now has a distinct name; the following are the 
new names: 

ALL block Area allocation XAB 

DAT block File date XAB 

KEY block File key XAB 

PRO block File protection XAB 

SUM block File summary XAB 

• The following symbol declaration macros are documented: 

FAB$BT Declare FAB value and mask symbols 

NAM$BT Declare NAM block value and mask symbols 

RAB$BT Declare RAB value and mask symbols 

XAB$BT Declare XAB value and mask symbols 

/\Onuf 9 uc^xoLC nuu u±OuK »yuiDOj.£i 

XBDOF$ Declare DAT block symbols 
XBKOF$ Declare KEY block symbols 
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XBPOF$ Declare PRO block symbols 
XBSOF$ Declare SUM block symbols 

• The description of each operation macro includes the use and 
meaning of each associated control block field. 

• The value of each RMS-11 user symbol is documented. 

• The structure of each RMS-11 user control block is 
documented. 

• The FAB has a new LRL (longest record length) field for 
sequential files (corresponding to the VAX-11 RMS XAB LRL 
field) . 

• The date/time XABs have changed in size from 36 to 46 octal 
bytes. 

• For ANSI magnetic tape, RMS-11 allows fixed-format records to 
be less than 18 bytes. 

• <CTRL/Z> and <ESC> are no longer recognized as record 
terminators for stream files; and <CTRL/Z> is no longer 
recognized as a file terminator for stream files. 

• RMS-11 now pads stream files with null characters to the high 
block of the file (not just to the end of the current block) . 
This means that RMS-11-created stream files can be read by 
programs that do not recognize the EOF value from the file 
header. 



2.2.3 RSX-llM/M-PLUS RMS-11 Utilities (N) 

The RSX-llM/M-PLUS RMS-11 Utilities manual is a new manual for this 
release, replacing Chapter 9 of the RMS-11 User's Guide for RMS-11 
Version 1.8. It documents the following technical changes: 

• The RMS-11 File Design Utility (RMSDES) is a new utility that 
allows you to interactively design and create files. RMSDES 
supersedes the RMS-11 File Definition Utility (RMSDEF) . 

• The RMS-11 File Display Utility (RMSDSP) provides more 
information about magnetic tape files and about backup files 
on disk and on magnetic tape (container files) , and provides 
an optional detailed display for backup files. The displays 
also appear in a more readable format, and the size field 
shows both the allocated and used sizes of the file. 

• The /DS switch to the RMS— 11 Indexed File Load Utility 
(RMSIFL) has been enhanced to allow specification of a 
different device for RMSIFL's temporary files. 

• The /SL switch to the RMS-11 File Conversion Utility 
(RMSCNV) , the File Back-Up Utility (RMSBCK) , and the File 
Restoration Utility (RMSRST) has been modified to append 
summary listings of processing to a single file if that file 
exists. 

• Five switches have been added to the RMS-11 File Conversion 
Utility (RMSCNV): the /CA switch, the /EO switch, the /IM 
switch, the /KN switch, and the /ML switch. The /CA switch 
creates an output file with the attributes of an existing 
file; the /EO switch changes ASCII stream files that end 
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with a CTRL/Z character to end with null characters; the /IM 
switch reads and writes records in block mode; the /KN 
switch reads an indexed file using a key name; and the /ML 
switch explicitly sets the limit of memory allocation. The 
/PD switch no longer requires a number sign (#) before an 
octal padding character or quotation marks around an ASCII 
padding character unless it is a lowercase character, a 
space, or a tab. 

• In addition, RMSCNV file conversion operations can now 
specify files on remote nodes. On systems with DECnet 
network capabilities and on which RMSCNV has Data Access 
Protocol (DAP) support, RMSCNV file conversions can take 
place not only locally, but over the network as well. You 
can convert files between a local and a remote node, or 
between two remote nodes. 

• One switch has been added to the RMS-11 File Restoration 
Utility (RMSRST) : /CV. The /CV switch converts file version 
numbers from octal to decimal for files created and backed up 
on RSX-llM/M-PLUS systems and restored to VAX/VMS systems; 
and from decimal to octal for files created and backed up on 
VAX/VMS systems and restored to RSX-llM/M-PLUS systems. 

• All utilities now display information in lowercase letters, 
and the error message format for all utilities (except 
RMSDEF) has been changed. 



2.3 COMPARISONS WITH RMS-11 VERSION 1.8 

Conversion from RMS-11 VI. 8 to RMS-11 V2.0 has been made transparent 
where possible. Structural changes required by feature additions, 
however, may be significant to some programs. 



2.3.1 Memory-Resident Library (RMSRES) 



RMSRES now contains all RMS-11 support code 
code in the task. The library is also: 



save for minor linkage 



• "Task-independent," which means that it can be rebuilt or 
replaced and the tasks that use it need not be rebuilt 

• "Clusterable," which means that it can share task virtual 
memory with other libraries that support "clustering" (see 
your FMS and language documentation) 

These features required changes in the RMSRLX.ODL file, the file 
normally used to build tasks using RMSRES. Tasks that used RMSRLX.ODL 
with RMS-11 VI. 8 should continue to build properly using the new 
RMSRLX.ODL and RMSRES. Build files that used RMSRES but did not use 
RMSRLX.ODL with RMS-11 VI. 8 must be changed to use (or incorporate the 
contents of) the new RMSRLX.ODL file. 



2.3.2 Memory-Resident Library (RMSSEQ) 

RMS-11 V2.0 contains no library equivalent to the RMSSEQ 
memory-resident library included with RMS-11 VI. 8. RMSSEQ offered no 
advantages in use of task virtual memory, and no advantages in use of 
system physical memory which are not equally attainable through use of 
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disk-overlaid RMS-11 at negligible performance cost. In addition, 
structural constraints made it impossible for RMSSEQ to be clusterable 
or task- independent. 

The improved packaging of the full-function library RMSRES should make 
it a suitable replacement for RMSSEQ in most environments. Where this 
is inappropriate, disk-overlaid or non-overlaid RMS-11 can be used. 



2.3.3 Memory-Resident Library (DAPRES) 

If your system includes the necessary DECnet facilities, the new 
resident library DAPRES provides support for remote file and record 
access as well as local access. Like RMSRES, DAPRES is both 
task-independent and clusterable. In particular, a task using RMSRES 
may include remote-access support via DAPRES with negligible increase 
in task virtual address space requirement by clustering the two 
libraries: the file DAPRLX.ODL should be used to generate this 
configuration. 



2.3.4 Disk-Overlaid RMS-11 

Structural changes to the RMS-11 code were performed so that the 
RMS-11 VI. 8 ODL files RMSllX, RMS12X, and RMSllS would remain valid. 
Most other ODL structures will probably continue to be valid, although 
validity cannot be guaranteed for all cases. Use of VI. 8 ODL 
structures with V2.0 code may require more task virtual address space 
than with VI. 8 code. 

The new versions of RMSllX, RMS12X, and RMSllS use approximately the 
same (or slightly less) task virtual address space as their VI. 8 
counterparts used with the VI. 8 code. If your system includes the 
necessary DECnet facilities, the new file DAPllX.ODL provides support 
for remote file and record access as well as local access. 

The ODL MAKRMSODL.CMD is not provided and should not be used with V2.0 
of RMS-11. However, a prototype ODL file, RMSll.ODL, is provided, and 
contains extensive comments. This file is not meant to be used 
directly, but may be helpful in designing your own ODL structures or 
in modifying the structure of the above ODL files to suit your special 
needs, 

A restriction on ODL structures involves the RMS-11 entry point 
modules ROxxxx (where xxxx represents the leading characters of the 
RMS-11 operation name, for example, ROPUT) . These modules, which were 
not explicitly referred to in previous RMS-11 ODL files, must not be 
referred to in RMS-11 ODL files for V2.0; if they are, a multiple 
definition for symbols of the form $RMxxx will occur. 



2.3.5 Non-Overlaid RMS-11 

While the total end-to-end size of RMS-11 has decreased despite 
addition of new features, the space savings and feature additions have 
not been spread evenly throughout. Most of the added features have 
occurred in the areas of file/directory operations and record 
operations for sequential files. 
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The result is that applications using non-overlaid RMS-11 for 
sequential-file-only access may experience an increase in virtual 
address space requirements for the RMS-11 code. If this presents a 
problem, it should normally be possible to select a suitable RMS-ii 
disk-overlay structure without noticeable performance impact. 



2.3.6 Other RMS-11 Version 1.8 Compatibility Notes 

• The utility RMSDFN is no longer supported. 

• There is no longer a distinction between "standard" RMS-11 and 
"UK" RMS-11. All RSX-llM/M-PLUS systems automatically 
include the appropriate files needed for RMS-11, including 
indexed support. 

• Programs that have been compiled under RMS-11 VI. 8 should in 
virtually all cases still run under V2.0, without 
recorapilation when relinked. Such programs, however, will not 
be able to take advantage of any new features in Version 2.0 
of RMS-11. 

• Tasks already built using RMS-11 VI. 8 should continue to run 
correctly (without rebuilding) on RSX-llM V4.1. However, it 
is possible that RMS-11 VI. 8 (or prior) tasks will not execute 
correctly on versions of RSX-llM after V4.1. RMS-11 V2.0 has 
been implemented to anticipate this possible change in 
RSX-llM: this allows you one full release cycle to convert 
any such tasks to RMS-11 V2.0. 

• In general, RMS-11 V2.0 cannot be run on a previous version of 
RSX-llM. 

RMS-11 V2.0 depends on new features included in the FllACP and 
on the new structure of TKB autoload vectors in V4.1 of 
RSX-llM; do not try to use old versions of TKB to link RMS-11 
V2.0 programs. 

Note: The reverse situation can also cause certain problems. 
Because of the change in TKB autoload vector format, a task 
that was linked with new TKB but old RMS-11 (VI. 8 or before), 
and that uses RMS-11 asynchronously, will behave 
unpredictably. 

• With RMS-11 V2.0, some changes to the SYSLIB modules have been 
made; several modules have been placed in SYSLIB to maintain 
compatibility with previous releases. 

As a result, you must be careful to reference RMSLIB as a 
"search" library before referring to SYSLIB when building 
tasks that use non-overlaid RMS-11. (This is only necessary 
if you need to make an explicit reference to SYSLIB as a 
"search" library when task-building.) 

• MACRO-11 programs using RMS-11 should always check for errors 
by checking the value of the appropriate STS field. 

With VI. 8, the C-bit may have been returned on RMS-11 errors. 
However, this is not a defined error return and has not been 
maintained in RMS-11 V2.0. 

• <CTRL/Z> and <ESC> are no longer recognized as record 
terminators for stream files, and <CTRL/Z> is no longer 
recognized as a file terminator for stream files. 
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Note that RMSCNV has a new switch, /EO, which can be used to 
convert stream files which were created by a non-RMS-11 
program, and which used <CTRL/Z> as the file terminator. 

• The expanded string Is now an output from the OPEN and ERASE 
operations by file-id. 

• RMS-11 now makes a check that at least 2 keys fit into a 
bucket. Therefore, with a bucket size of 1, the maximum key 
size is 243. 

• When block I/O is used, OPEN and DISPLAY operations no longer 
return relative or indexed file key XAB, allocation XAB, or 
summary XAB information. 



2.4 MISCELLANEOUS INFORMATION 



• Note that all the new features provided in RMS-11 are fully 
accessible only to the MACRO-11 programmer; for high-level 
languages, check the language documentation for supported 
features. 

• For magnetic tape, RMS-11 now allows ANSI fixed format tape 
records to be less than 18 bytes. In addition, RMS-11 
supports the full set of ANSI tape names as quoted strings. 
This includes the full set of ANSI 'a' characters, up to 17 
bytes. 

• Several RMS-11 demonstration programs have been included on 
the distribution kit. These sample programs are provided as 
MACRO-11 sources and task images; they illustrate how to use 
the new PARSE/SEARCH/RENAME/ERASE operations and wildcarding 
facilities. A GSA source routine is also included to 
illustrate how to extend the task in the event of RMS-11 pool 
exhaustion. 

The names of the programs are PARSE, SEARCH, RENAME, ERASE, 
and GSA. 

• The RMSIFL and RMSDES utilities and the remote access (DAP) 
support code in RMS-11 V2.0 will run only on CPUs that support 
the EIS instruction set. 



2.5 PROBLEMS FIXED WITH RMS-11 VERSION 2.0 

• The problem that was reported for RMS-11 VI. 8 on GET after 
FIND on alternate keys (Dispatch article number 48.2.20) has 
been fixed for RMS-11 V2.0. 

• RMSIFL VI. 8 did not load indexed files correctly if the key 
type was integer. (Not all records could be accessed by key 
value.) This problem has been fixed in the new version of 
RMSIFL. 

• RMS-11 now pads stream files with nulls, to the high block of 
the file (not just to the end of the current block). This 
will make RMS-11-created stream files readable by programs 
that do not recognize the EOF value from the file header. 
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2.6 KNOWN PROBLEMS WITH RHS-11 VERSION 2.0 



• Under some circumstances, the deferred write option may be 



! ftnr\ r ai^ 
"•■3'*"- -~' ' 



Use of the mass-insertion feature may occasionally cause the 
error ER$DME. 

When you use RMSDES and specify a GET command, RMSDES 
incorrectly requests write access on the GET file. In some 
cases, an ER$FLK or ER$PRV error may result if your task does 
not have write access to the file. 



2.7 RMS-11 FILES AND PLACEMENT ON THE DISTRIBUTION KIT 



File Name 



Destination 



Comments 



RMSMAC.MLB 
RMSLIB.OLB 
RMSDAP.OLB 

RMSBCK.TSK 
RMSRST.TSK 
RMSDEF.TSK 
RMSDSP.TSK 
RMSCNV.TSK 
RMSDES. TSK 
RMSIFL.TSK 

RMSDES. IDX 

RMSll.ODL 

RORMSl.MAC 

RMSllS.ODL 

RMS12S.0DL 

RMSllX.ODL 

RMS12X.0DL 

RMSRLX.ODL 

DAPllX.ODL 

DAPRLX.ODL 

RMSRES.TSK 

RMSRES.STB 
RMSRES.MAP 



LB: [1,1] 
LB: [1,1] 
LB : [ 1 , 1 ] 

LB: [1,54] 
LB: [1,54] 
LB: [1,54] 
LB: [1,54] 
LB: [1,54] 
LB: [1,54] 
LB: [1,54] 

LB: [1,2] 

LB: [1,1] 
LB: [1,1] 
LB: [1,1] 
LB: [1,1] 
LB: [1,1] 
LB: [1,1] 
LB: [1,1] 
LB:[1,1] 
LB:[1,1] 

LB: [1,1] 

LB : [ 1 , 1 ] 
LB: [1,34] 



Can be deleted if you are not using 

MACRO-11 RMS-11 programs. 

Object library for RMS-11 local 

access. 

Object library for RMS-11 remote 

access. Can be deleted if you do 

not need remote access. 



RMSBCK utility 
RMSRES. 

RMSRST utility 
RMSRES. 

RMSDEF utility 
RMSRES. 

RMSDSP utility 
RMSRES. 

RMSCNV Utility 
RMSRES. 

RMSDES Utility 
RMSRES. 

RMSIFL Utility 
RMSRES. 



does not use 
does not use 
does not use 
does not use 
does not use 
does not use 
does not use 



Indexed help file used by RMSDES. 

Prototype ODL file. 

For use with the prototype ODL. 

ODL file for sequential. 

ODL file for sequential. 

Standard indexed file ODL. 

Indexed file ODL. 

ODL for use with RMSRES. 

ODL for use with overlaid RMSDAP. 

ODL for use with DAPRES. 

TSK image for linking against 

RMSRES. 

STB file for RMSRES. 

Map file for RMSRES. 



((jontinuea on next page) 
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File Name 



Destination 



Comaents 



RMSRESSUB.TSK 


LB: 


[1,1] 


RMSRESSUB.MAP 


LB: 


[1,34] 


DAPRES.TSK 


LB: 


[1,1] 


DAPRES.STB 


LB: 


[1,1] 


DAPRES.MAP 


LB: 


[1,34] 


RMSRES.CMD, 


LB: 


[1,24] 


RMSRES.ODL 






DAPRES.CMD, 


LB: 


[1,24] 


DAPRES.ODL 






BCKNON.CMD, 


LB: 


[1,24] 


BCKNON.ODL 






BCKNRN.CMD, 


LB: 


[1,24] 


BCKNRN.ODL 






CNVNON.CMD, 


LB: 


[1,24] 


CNVNON.ODL 






CNVNRN.CMD, 


LB: 


[1,24] 


CNVNRN.ODL 






CNVNOO.CMD, 


LB: 


[1,24] 


CNVNOO.ODL 






CNVNRR.CMD, 


LB: 


[1,24] 


CNVNRR.ODL 






DEFNON.CMD, 


LB: 


[1,24] 


DEFNON . ODL 






DEFNRN.CMD, 


LB: 


[1,24] 


DEFNRN.ODL 






DESNON.CMD, 


LB: 


[1,24] 


DESNON.ODL 






DESNRN.CMD, 


LB: 


[1,24] 



DESNRN.ODL, 
RMSDES.ODL 

DSPNON.CMD, 
DSPNON.ODL 
DSPNRN.CMD, 
DSPNRN.ODL 

IFLNON.CMD, 
IFLNON.ODL 
IFLNRN.CMD, 
IFLNRN, ODL 

RSTNON.CMD, 
RSTNON.ODL 
RSTNRN.CMD, 
RSTNRN.ODL 

RMSUTL.OLB, 
RMSODL.ODL 



LB; 



LB: 


[1,24] 


LB: 


[1,24] 


LB: 


[1,24] 


LB: 


[1,24] 


LB: 


[1,24] 


LB: 


[1,24] 



1,24] 



Subset library. 

Map file for subset library. 

Task image for RMSDAP resident 

library. 

STB file for DAPRES. 



For rebuilding RMSRES. 



For rebuilding DAPRES, 



For rebuilding the overlaid 
version of RMSBCK. 
For rebuilding the resident- 
library version of RMSBCK. 

For rebuilding the overlaid 
version of RMSCNV. 
For rebuilding the resident- 
library version of RMSCNV. 
For rebuilding the overlaid 
version of RMSCNV, with RMSDAP. 
For rebuilding the resident- 
library version of RMSCNV, with 
RMSDAP. 

For rebuilding the overlaid 
version of RMSDEF. 
For rebuilding the resident- 
library version of RMSDEF. 

For rebuilding the overlaid 
version of RMSDES. 
For rebuilding the resident- 
library version of RMSDES. 



For rebuilding the overlaid 
version of RMSDSP. 
For rebuilding the resident- 
library version of RMSDSP. 

For rebuilding the overlaid 
version of RMSIFL. 
For rebuilding the resident- 
library version of RMS I F L , 

For rebuilding the overlaid 
version of RMSRST. 
For rebuilding the resident- 
library version of RMSRST. 

For rebuilding several utilities. 



(Continued on next page) 
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File Name 



Destination 



Conments 



USA.KAU 



PARSE. MAC, 
SEARCH. MAC, 
RENAME. MAC, 
ERASE. MAC, 
PARSE. TSK, 
SEARCH. TSK, 
RENAME. TSK, 
ERASE .TSK 



Ln: i^uu, J.J 



LB: [200,1] 



Demonscrai:ion progEam incxuueu 

as an illustration of how to extend 

an RMS-11 task in the event 

of pool exhaustion. 

Demonstration programs for the 

new directory and wildcarding 

facilities. 



Note that all RMSDAP files can be deleted if you are not using 
to access files on remote nodes. 



RMS-11 



2.8 RHS-11 VERSION 2.0 INSTALLATION 

On most RSX-llM systems, all RMS-11 files are 
system after system generation. 



automatically on your 



However, for systems that were generated using distribution kits on 
RLOl/02 or RK06/07 disks or the magnetic tape versions of these kits, 
the RMS-11 files must be transferred after system generation. If your 
system was not generated using one of these kits, you may want to skip 
this section, and continue with Section 2.8.2, Startup Command 
Procedures . 



2.8.1 RLOl/02 and RK06/07 Procedures 

To transfer RMS-11 files to RLOl/02 and RK06/07 
execute the command procedure [1 ,2]RMSINSTAL.CMD. 
fully documented in the RSX-llM System Generation 
Guide. 



disks, you must 
This procedure is 
and Installation 



2.8.2 Startup Command Procedures 

If all the RMS-11 files have been transferred to your system, all that 
remains to be done is to install the resident libraries and RMS-11 
utilities at system startup. To aid you in installing them, the file 
LB: [1,2] STARTUP.CMD contains sample comments that can be edited to 
become system startup commands. 

You must allocate a partition for each resident library you are using, 
using the SET command(s). Note that you must allocate a partition 
called RMSRES, and install in that partition either the full-function 
resident library (RMSRES) or the subset library (RMSRESSUB.TSK) . If 
you always plan to use the same library (no alternating between the 
full-function and the subset library) , and you want to save disk 
space, you can delete the task image you are not using. 

But, if you delete the full-function RMSRES. TSK and plan to use only 

RMSRESSUB.TSK, you should rename RMSRESSUB.TSK to RMSRES. TSK. Then 

user programs and RMS-11 utilities will always link against the task 
named RMSRES. 
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NOTE 

If you are using the subset library and 
you rebuild the RMS-11 utilities to use 
the subset library, utility functions 
involving indexed files will be 
invalidated. 



You can include the SET commands in your startup command file, or you 
may want to include the RMSRES and DAPRES partitions permanently in 
your system by doing the following: 

• Using the SET commands to include the necessary partitions. 

• Using the INSTALL commands to install the tasks in the running 
system. 

• Using the SAVE command to save RMSRES and DAPRES into the 
system image. 

See your RSX-llM/M-PLUS MCR Operations Manual for more details on 
these commands. 



2.8.3 Utility Configurations 

The RMS-11 utilities that are provided on the distribution kit are 
built to use disk-overlaid RMS-11. 



2.8.3.1 Utility Command and ODL Files - For each utility, a command 
and ODL file is provided which can be used to build the utility using 
disk-overlaid RMS-11. The names of the files are the following: 



For RMSBCK 
For RMSRST 
For RMSCNV 
For RMSDSP 
For RMSDES 
For RMSDEF 
For RMSIFL 



BCKNON.CMD,BCKNON.ODL,RMSODL.ODL 
RSTNON . CMD , RSTNON . ODL , RMSODL . ODL 
CNVNON.CMD,CNVNON.ODL 
DSPNON.CMD, DSPNON. ODL, RMSODL. ODL 
DESNON . CMD , DESNON . ODL , RMSDES . ODL 
DEFNON . CMD, DEFNON . ODL , RMSODL . ODL 
IFLNON.CMD, IFLNON. ODL 



For RMSCNV, two additional configurations are available, if you want 
to use RMSCNV to access files on remote nodes. To build RMSCNV using 
the clustered RMS-11 and RMSDAP resident libraries, you can use 

For RMSCNV: CNVNRR.CMD,CNVNRR.ODL 

To build RMSCNV using disk-overlaid RMS-11 and RMSDAP, you can use 

For RMSCNV: CNVNO0.CMD,CNVN0O.0DL 
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For each utility, a command and ODL file are provided which can be 
used to build the utility using the resident library RMSRES. The 
names of the files are the following: 



For RMSBCK 
For RMSRST 
For RMSCNV 
For RMSDSP 
For RMSDES 
For RMSDEF 
For RMSIFL 



BCKNRN 
RSTNRN 
CNVNRN 
DSPNRN 
DESNRN 
DEFNRN 
IFLNRN 



.CMD, BCKNRN. 
.CMD, RSTNRN. 
•CMD, CNVNRN. 
•CMD, DSPNRN. 
.CMD, DESNRN, 
.CMD, DEFNRN. 
, CMD, IFLNRN. 



ODL 
ODL 
ODL 
ODL 
ODL 
ODL 
ODL 



2.8.3.2 Rebuilding the Utilities - To rebuild the utilities, you must 
take the following steps: 

• Log in to a privileged account. 

• Set your default account to [1,24] on the system disk, 

• Use TKB to build the utility or utilities. 

The utilities and the corresponding map files will be built in the 
current account; you may then want to put the utility in a system 
account ( [1 ,54] ) . 

Each command file for a particular utility creates a utility of the 
correct name. So, for example, CNVNRN.CMD and CNVNON.CMD both produce 
task images called RMSCNV. TSK; one is built against the resident 
library and one is built with disk-overlaid RMS-11. 

Finally, note that the RMSIFL utility command files include an EXTTSK 
value that is used to increase the size of internal buffers, thereby 
allowing RMSIFL to load larger-sized files and files with many area 
and key definitions. 

The default EXTTSK which is specified is fairly large. If you want a 
smaller version of RMSIFL, you can simply install RMSIFL with a 
smaller increment using the /INC switch. The /INC switch will 
override the EXTTSK directive. 



The EXTTSK value however, must be greater than 2048 
If the value is too small, you may get the 
exhausted," or a SORTs error code. 



(decimal) words, 
error "IFL memory 



2.9 REPORTING PROBLEMS 

Software Performance Reports (SPRs) allow you to report any problems 
directly to DIGITAL. The general procedure for submitting an SPR is 
described in Sections 1.4 and 1.4.1. The following additional 
information should be submitted with SPRs on RMS-11: 

1. Include the version number and patch level of the RMS-11 that 
you are using. 

2. Indicate whether you are using a programming language to 
process the file(s) and include the version number and patch 
level of the language. 
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3. If RMS-11 aborts (or if some other task crashes and RMS-11 
appears to be the cause) , include a post-mortem dump and a 
map of the task involved. 

4. Include copy(s) of the file(s) involved, in RMSBCK format. 

5. If the errors are reproducible, include copies of the files 
that can cause the error. If the problem is not 
reproducible, include a copy of the corrupt file if possible. 

6. For RMS-11 utilities, include also a description of the 
command line(s) or interactive session that led to the error. 

Include a listing of the actual error that occurred, if 
possible. 
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CHAPTER 3 
RSX-llS VERSION 4.1 RELEASE NOTES 



3.1 NEW FEATURES FOR RSX-llS V4 . 1 

RSX-llS V4.1 software is an update of the memory-resident RSX-llS 
operating system. The major new functions of RSX-llS V4.1 are 
documented in the following sections. 



3.1.1 New Devices 

RSX-llS V4.1 supports the same new devices that RSX-llM V4.1 supports. 

3.2 NOTES ON SOFTWARE 

The following sections describe incompatibilities that exist between 
RSX-llS V4.1 and previous versions and provide miscellaneous 
information. 

3.2.1 Host Hardware Configuration Requirements for RSX-llS SYSGEN 

To do an RSX-llS SYSGEN, the host system must be mapped and have at 
least 64K words of memory. 

3.2.2 Fixing Tasks on RSX-llS with PLAS Support 

To correct problems caused by the logic in VMR that determines whether 
tasks are overlaid or nonoverlaid, VMR now has a new method for 
determining how tasks (regardless of whether they are overlaid or 
nonoverlaid) are fixed into memory. 

Instead of using two different methods to fix tasks into memory as in 
previous releases, VMR now requires that all tasks in a RSX-llS system 
with PLAS support be fixed by issuing the following VMR command line: 

VMR>INS task/FIX=YES 

Using the VMR INSTALL /FIX command provides access to the label block, 
thus allowing VMR to determine whether the task is overlaid or not. 
Note that this is a significant change from the way tasks were fixed 
in PLAS systems in previous releases. Only the memory-resident 
overlaid tasks had to be fixed using this command; now all tasks in 
the PLAS system must be fixed using the VMR INSTALL /FIX command. 
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3.2.3 VMR Support for Systems Larger than 124. K Words 

VMR for RSX-llM V4.0 did not support fixing tasks above the 124. K word 
limit even though RSX-llS V4.0 contained support for systems larger 
than 124. K words. VMR for RSX-llM V4.1 now contains limited support 
for systems larger than 124. K words. This limited support will enable 
you to do the following: 

• Fix tasks above the 124. K word limit (using FIX) 

• Load drivers above the 124. K word limit (using LOAD) 

• Install commons above the 124. K word limit (using INS) 

However, the support is limited, and there are two restrictions which 
must be adhered to: 

• IISGEN still creates a maximum system image file of 
498 (decimal) blocks for a system of 124. K words. To fix tasks 
above 124. K words, you must first create another copy of the 
system image file large enough for the system size. 

• The VMR SAV command still can only be used for systems smaller 
than 124. K words. 



3.2.4 RSX-llS System Generation 

3.2.4.1 Performing an RSX-llS V4.1 System Generation on an 
RSX-llM-PLUS VI. Host - If you intend to perform an RSX-llS 
V4.1 system generation while running under an RSX-llM-PLUS VI. 
system, you must update the VI. indirect object library 
{ [l,24]IND.OLB) , and rebuild indirect before performing the system 
generation. 

A concatenated object file, INDFIX.OBJ, is in UFD [1,54] of the 
RSX-llS distribution kit. (This object file is on the first volume in 
multimedia kits.) Refer to Section 1.3.2.1 of these Release Notes for 
more information on this file. 

The procedure for updating is as follows: 

1. Set the UIC to [1,24] . 

2. Copy INDFIX.OBJ to the disk that has IND.OLB. 

3. Issue the following command: 

LBR IND/RP=INDFIX 

4. Assign the logical names IN: and MP: to their proper 
devices. 

5. Verify that RSXllM.STB resides in [1,54]. 

6. Task-build Indirect: TKB glNDBLD. 

7. Install the new indirect task image. 

When you have completed this sequence of steps, you are ready to 
perform an RSX-lls V4.1 system generation. 
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NOTE 

It is not necessary to update indirect 
if your host is RSX-llM-PLUS V2.0. 



3.3 NOTES TO THE RSX-llS SYSTEM GENERATION AND INSTALLATION GUIDE 

The following sections contain information that modifies and 

supplements the information in the RSX-llS System Generation and 
Installation Guide. 



3.3.1 Distribution Kits 

RSX-llS V4.1 is now distributed on the following media: 

1. One RK06 cartridge disk 

2. One RK07 cartridge disk 

3. One RLOl cartridge disk 

4. One RL02 cartridge disk 

5. One magnetic tape, 9-track, 800 bpi , 2400-foot 

6. One magnetic tape, 9-track, 1600 bpi, 2400-foot 

Note that RSX-llS is no longer distributed on RK05 disks. All 
references to the RK05 distribution kit in the manual no longer apply. 

3.3.2 Q-Bus Terminal Interfaces 

Section 2.1 of the manual implies that you can only choose UNIBUS 
terminal interfaces (for example, DHll and DZll) for your system. If 
you have a Q-bus machine (for example, a PDP-11/23-PLUS) , you can 
choose a Q-bus terminal interface (for example, a DLVll or DZVll) for 
the Q-bus machine. 

3.3.3 Transferring Task Image Piles Using FLX 

On page 2-7, the FLX command lines to transfer task image files from a 
Files-11 format to either an RT-11 format or a DOS-11 format are 
incorrect. To transfer an image file from Files-11 format to DOS-11 
format, type the following command lines: 

FLX>CT:/ZE/DC 

FLX>/DO= [ 1 , 50 ] S I P . TSK/RS 

To transfer an image file from Files-11 format to RT-11 format, type 
the following command lines: 

FLX>DX:/ZE/RT 

FLX>DX : /RT= [ 1 , 50 ] S IP . TSK/RS 

For a full description of FLX, see the RSX-llM/M-PLUS Utilities 
Manual. 
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3.3.4 SETTIM 

The sections of the manual that refer to SETTIM as a separate 
subroutine (Sections 2.5 and 4.5.1.5) do not apply. SETTIM is a 
FORTRAN callable subroutine that is stored in SYSLIB. See the 
RSX- 1 1 M/M- P LU S Executive Reference Manual for information on the 
SETTIM subroutine. 



3.3.5 Building a Resident Subset PCS Library 

The following information on how to build a resident subset FCS 
library for RSX-llS V4.1 supersedes the information in Section 
4.7.1.3. 

Create the resident library by assembling the file [2 ,200] IISRES.MAC 
and building it according to the directions given in the file itself. 
Two new entry points, .FCTYP and .FLUSH, have been added to make 
subset FCS conform to standard FCS. 

The following descriptions of the new entry points supplement the 
information in 2.7.3. 

.FCTYP Returns with Rl clear to indicate this is the record 
I/O-only version of FCS. 

.FLUSH This routine is a NOP for record FCS and returns 
success. 

For more information on building, defining, and loading resident 
libraries, see the RSX-llM/M-PLUS Task Builder Manual and the RSX-llM 



System Generation and Installation Guide . 



3.4 SYSGEN DIALOGUE FROM AN RSX-llM HOST 



3.4.1 Introduction 



This section contains the actual terminal dialogue from an RSX-llS 
system generation on an RSX-llM host. 

The dialogue and procedures in Phase I are the same for RSX-llM and 
RSX-llS; for detailed explanations of the Phase I system generation 
questions, see the RSX-llM System Generation and Installation Guide . 

The system generated in the example in this section supports the 
following hardware configuration for a PDP-11/23-PLUS processor: 

128K memory 

60 cycle line clock 

RL02 cartridge disk controller with two drives 

TU58 DECtape controller with two drives 

LP-11 line printer controller 

null device driver 

DZVll terminal interface 

DLVll terminal interface 
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The following software support is included: 

• Large (20K) RSX-llS Executive 

• Support for: 

Executive common 

Memory management 

Send/receive directives 

Get mapping context directive 

Address checking 

I/O rundown 

Loadable device drivers 

ASTs 

Powerfail recovery 

Logical device assignment 

Crash notification 

Group global event flags 

Memory parity 

• TKTN 

• XDT 

• System-controlled partitions 

• Basic MCR with support for OPEN, ATL/TAL, and full 
error-message text 

• OTL with support for full error-message text and for all OTL 
devices generated into the RSX-llS system 

• SIP with support for full error-message text and for all SIP 
devices generated into the RSX-llS system 

• RSDVIH 

• RSX-llS Subset File Control Services (FCS) 

The system generation is being performed on an RSX-llM V4.1 RL02 
release kit baseline system disk. The RSX-llS release kit consists of 
one RL02, labeled llSKITl. 

Questions calling for a YES/NO answer can be answered by pressing the 
RETURN key for a NO answer. 

You can also answer questions asking for a value and displaying a 
default value by pressing the RETURN key to specify the default 
answer. 



Notes ; 



• You may want to do a preliminary system generation before you 
do your actual SYSGEN. To do a preliminary SYSGEN (PREPGEN) , 
you invoke the command file for Phase I of the SYSGEN 
(gllSGEN) and answer YES to the question, "Do you want to 
inhibit execution of MCR commands (PREPGEN)?" 
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Phase I continues, but the answers you give to the questions 
are placed in a saved answer file instead of being used 
immediately. When Phase I finishes, you reinvoke 11SGEN.CMD 
to run the phase again. This time, you do not inhibit MCR 
command line execution and the SYSGEN procedure uses the 
answers in the saved answer file. 

Doing a PREPGEN saves time and prevents mistakes. The sample 
dialogue in the following section shows a PREPGEN being done 
before the actual SYSGEN. 

During Phase I of the system generation procedure, 11SGEN.CMD 
asks for the device configuration of your system and also 
which system directives you would like in the Executive. In 
both cases, you can print out a table of the available options 
before you answer the question. 



3-6 



RSX-llS VERSION 4.1 RELEASE NOTES 



3.4.2 Actual Dialogue — RSX-llS System Generation on an RSX-llM Host 

RSX-llM y4.1 BL35-A 124. K MAPPED (BASELINE) 
>RED nL;=SYi 
>RED riL:=l-B! 
>MOU DL.!RSXhf35 
:>(?DLJi;i>2:STARTUP 

>« PLEASE ENTER TIME AND DATE (HRJMN DD-MMM-YY) LSli 13:02 15-MAR-83 
>TIM 13! 02 15-HAR-83 

>* ENTER LINE WIDTH OF THIS TERMINAL CD DJ132.a: 
>SET /BUF=Ti;i32. 
>ACS SY:/BLKS=512. 
>(3 <EOF> 

>MOU DLlSllSKITl 
>PIP rFLO:C200,2003/NU=DLi;C2 f20311SGEN.CMD rllSGEN2.CMD 

>riMO DLi: 

DM0 — TTO; dismounted from DLI J *** Final dismount initiated *** 

13: 11100 *** DLi: — Dismount complete 

>@11S6EN 

> f 

>i RSX--11S Version 4.1 BL35-A Sustem Generation done on RSX-llM 

> r 

>i Copyright (C) 1979, 1981 j 1983 

>f Digital Eciuipment Corporation? Maynardj Mass. 

>> All Rights Reserved. 



RL01/RL02 distribution kit 



>* 
>* 
>* 
>* 



3. 
5 * 
6. 
9. 



Do you want to inhibit execution of MCR commands (PREPGEN)? CY/Hli 

Are you generating an unmapped sasteBi? CY/N3J 

Use an input saved answer file? CY/NHJ 

Name of output saved answer file CD: SYSSAVED.CMD3 CSa: 



>f Phase I output saved answers created in file DLO : C200.200DSYSSAyED.CMDS 1 

>* 16. Enter device for EXCPRV disk when it is ready (ddu:) CDS DL1:D tSll DLl: 
>MOU DLIJEXCPRM 



>* 


1. 


>* 


2. 


>* 


3. 


>* 


4. 


>* 


6. 


>« 


8. 


>* 


10. 


>* 


11. 


>* 


12. 



Target configuration 

Processor Type CD: 11/343 LSli 11/23 

Does processor have a switch register? CY/N D'NUJ 

Memory size (in K-word blocks) CD R:16.-1920. D:16.3: 128. 

Include support for K-series devices? CY/N lUNH: 

Floating point processor (FP-11) present? CY/N D!N3: Y 

Extended instruction set (EIS) present? CY/N D:N3: 

Line freouenca: A- <40 Hz B- 50 Hz CD: A3 CSi: 

Kl)ll-Y Watchdog timer support? CY/N DJND! 

Memory parity support? CY/N D:N3: Y 

The response to the following Question specifies the highest interrupt 
vector. If you respond with a value less than or ectual to 400. SYSGEN 
will assign the value associated with the highest interrupt vector 
specified during the Peripheral Section. Therefore, if your system 
will include devices that are not specified during the Peripheral 
Section and which have vectors above 400 (devices such as K-series and 
certain communication devices), specify that value in the next Question. 

14. Highest interrupt vector CO R:0-774 UtOlit 

For device configuration; '*' Prints device table. '." Terminates inouiry 

"?• Prints current configuration 
Enter devices and number of controllers for devices which reouire drivers 

15. Devices CSK * 
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>i ripvice codes for A/D and industriBl/lsborstoru devices} 

.■'■■ 5 

>; AD- AtiOl-D A/D Converter 

>> AF- AFCll A/D Converter 

■■ ' AR-- ARll Loborstory Subsystem 

>f IC- ICRll/ICSll Industrial Control Subsystem 

>' IP- IP11/IP300 Industrial Control Subsystem 

>i IS- DRSll/DSSU Industrial Control Subsystem 

>» LA- L.PA11 1..3hor3tory Subsystem 

>f LS- I...PS11, Laboratory Subsystem 

>! Un- UDCll Universal Hisiitsl Controller 

-■=■ f 

>> Device codes for Interp rocessor communication devices! 

> 7 

>' XB~ DAJJ-B Interprocessor Link 

■■ ' XL- DLll-E Tnterprocessor Link 

>'r XM- DHCn-F/DMRU Interprocessor Link 

•• ' XP- DPll Synchronous Interface 

••' XQ- DQll ESynchronous Interface 

>' XU- DlJll Synchronous Interface 

'■' XU- DUF'll Synchronous Interface 

>> Device codes for unit record devices* 

!> i 

>i CR- CRll/CMll-E Card Reader 

>5 GR- VT11/VS60 Graphics Subsystem 

>? LP- LAli/LPll/LSll/LVll/LNOl Line Printer 

>> PP- PC 11 Paper Tape Punch 

>i PR- PCll/PRll Paper Tape Punch and Reader 

!^=' f 

>i Device codes for disk devices? 

y r 

>} DB- RP04/RP05/RP06 Disk Drive 

>i DD- TU58 Cartridge DECtape II 

>; DF- RFll FiKed Head Disk Drive 

>; DK- RK03/RK05 Disk Drive 

>5 DL- RL01/RL02 Disk Drive 

>i DM- RK06/RK07 Disk Drive 

>5 DP- RP02/RP03 Disk Drive 

>i DR- RM02/RM03/RM05/RM80/RP07 Disk Drive 

>f DS- RS03/RS04 Fixed Head Disk Drive 

>! DT- TU56 DECtape 

>} D!J- RA60/RA80/RA81/RC25/RD51/RX50 Disk Drive 

>f DX- RXOl Floppy Disk Drive 

>i DY- RX02 Floppy Disk 

>' EM- MLll Non-Rotatin3 Electronic Memory 

> f 

>i Device codes for Magnetic tape devices! 

> 5 

>r CT- TU60 Cassette Tape Drive 

>i MF- TU78 Magtape Drive 

>i MM- TU16/TU45/TU77/TE16 Magtape Drive 

>i MS- TS11/TU80/TSV05 Maatape Drive 

>t MT- TU10/TE10/TS03 MaStape Drive 

>i 

>f Device codes for terminal interface devices! 

>i 

>' YH- DHll/DHVll Asynchronous Terminal Interface 

>' YJ- DJll Asynchronous Terminal Interface 

>' YL- DLn-A/-B/-C/-D/-E/-J/-U Asynchronous Terminal Interface 

'• ' YZ- DZll/DZVll Asynchronous Terminal Interface 

>i Device codes for pseudo devices! 

!.'■■ ? 

>j CO- console device 

>f NL- null device 

y r 

>r Enter responses as! devl=number controllers » dev2=number controllersj ... 

>' If 3 devices is specified without the number of controllersT the number 

>i of controllers defaults to 1. 

> i 

>> EKaiiiPie! DKrDM=2 J YL> NL. 
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>* 


6, 


>* 


7. 


>* 


8. 


>* 


9. 


>J 




>r 




>« 


15. 


>« 


16. 


>f 




>* 


18. 


>* 


19. 


>* 


20. 


>* 


22. 


>* 


23. 


>« 


25. 


>* 


30. 


>* 


32. 


>* 


33, 


>* 


36, 
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>* 15. Devices LSli IiD> DL .LP> NL . YL. YZ . 

Processor511/23 Memora Size? 128Kj Mapped SastemJRSX-l IS 

Host conf isfurstion 

>* 1. Is 3 line printer sve liable? CY/NJ: Y 

>« 3. Does the listing/map device hsve st least 120 columns? ZY/Uli Y 

>* 4. Assembly listinSs device (dduJ) CD: 'NL:"] CSai 

>* 5. Map device for Executive and device drivers <ddu{) CD! DL1J3 CS]; 

.-■■■ 5 

>* EOS * Do you want toJ <CR>-continue R-repeat section E-exit p-psuse LSI', 

y ? 

>t Executive Options 

>f 

>J Answer Y(ES) if the following support is desired 

> ? 

Executive Common? CY/N]: Y 

Memory management (PLAS) directives? tY/NDJ Y 

Send/Receive by reference directives? CY/N3; Y 

Get meppina context directive? CY/Nl' Y 

Address checking support will be included 

I/O rundown support will be included 

Loadable device drivers? CY/N]! Y 

Should the default for all applicable drivers be loadable? CY/Nj! Y 

AST support will be included 

Include support for Cancel Selective Marktime? CY/N3J Y 

Task termination and device not ready messages (TKTN)? CY/N3! Y 

Power fail recovery? CY/N35 Y 

Lar-^e (20K) Executive? CY/N] J Y 

Logical device assignment? CY/N3J Y 

Do uou intend to include a user-written driver? CY/N3J 

Executive Debugging Tool (XDT)? CY/N]J Y 

Include support for communications products (such as DECnet)? CY/NDJ 

System controlled partitions? CY/N3' Y 

Group global event flags? CY/N3J Y 

For directives! 

* - Prints the table 

. - Terminates inciuiru 

y. - Gets all valid directives and terminates inauiry 

>* 37. Enter code for system directives ESUJ t 

A- Get partition parameters B- Get task parameters 

C- Send/Receive D- Alter priority 

E- Extend task F- Connect to interrupt vector 

G- Get sense switch H- Set system time 

I- Stop bit J- Specify rectuested exit AST 

K- Parent offspring tasking L- Parent offspring tasking with chaining 

Enter responses as codelcode2code3. , . <no commas) (e.g.! ABCDF.) 

>* 37. Enter code for system directives CS]t % 

>i SGN — WARNING — CPU does not have switch register 

— Get sense switch directive not included 

>* 38. Number of pre-allocated QIO packets CD RJ0.-15. DI5.]! 

>* 39, Size of data transfer vector in words CD R!0.-33, DJ33.3J 

>* 40, Round-robin scheduling interval in ticks CD R:0.-1000, D:5.]! 

>* 41. Highest priority class for consideration CD R:1.-249. DJ150,3: 

>* 42, Lowest priority class for consideration CD RJ1,-150, DJ1,]J 

>* 46, Seconds between printer not ready messages CD R50.-255. D!30.]: 

>* 48, System crash register and stack dump device CSR CO R:0-177700 D:1775643; 

>* 51, Crash dump analysis: A- PANIC B- Crash Dump Analysis <CDA) CD: B3 iSlt 

>* 52, CDA output notification device CSR CO R: 160000-177700 0:1775643: 

>* 53, Enter CDA memory dump device mnemonic (ddu!) CS R:3-43: DLi: 

>* 54, Enter CDA memory dump device CSR CO Rt 160000-177700 DJ 1744003: 
!> r 

>* EOS * Do you want toS <CR>-continue R-repeat section E-exit P-pause CS3: 
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>f Terminal driver options 

>j 

>* 1. Terminal driver desired (A/B/C/Dt * prints table) ISl', « 

>> 

>f Terminal drivers! A- Tsilorable half duplex 

>f B- Tailored half duplex (user-oriented) 

>; C- Full duplex 

>! n- Baseline half duplex 

> r 

>* 1. Terminal driver desired (A/B/C/Di * prints table) ZSli C 

>* 2. Unsolicited input timeout value in seconds CD R:0,-255. 01120. ]{ 

>i 

>S Answer Y(ES) if the followinS support is desired 

'^^ r 

>* 6. Unsolicited input character AST? CY/N]; Y 

>* 8. Breakthrough write? CY/NJ! Y 

>f CTRL/R support will be included 

>* 10. Escape sequence handling? ly/Hlt Y 

>* 11. Get multiple characteristics? CY/N3; Y 

>* 12. Set multiple characteristics? CY/N3! Y 

>« 13. Get terminal driver options? CY/N3; Y 

>* 17. Read after prompt? CY/N3! Y 

>* 20. CRT rubout support? lY/NJ: Y 

>* 25. Hardware unrecoverable input error notification? CY/N3J Y 

>* 26. Device independent cursor positionins? CY/NDt Y 

>* EOS * Do you want to? <CR>-continue R-repeat section E-exit F'-pause LSli 

Sustem Options 

Answer Y<ES) if the following support is desired 

>t 11. What name would uou like to ^ive aour sastem CD! RSXllSD CS R!0-6]: 

>* EOS * Do aou want to! <CR>-continue R-repeat section E-exit P-pause CSJ! 

Thinking . . . 

End of Executive option feneration at 13!40!10 on 15-MAR-83 

Peripheral configuration 

Parameters appearing in souare brackets "C...3' can onlu be 
specified for the first controller of a particular device. 
Parameters appearing in parentheses "(.,.)' onlu need be specified 
if the indicated option is present on the taraet sustem. 

The default for loadable drivers has been set to *TRUE*. 
To override this setting enter R (resident) as the first parameter 
for the first controller of the specified device. 

A/D and Laboratory devices! None specified 

Interprocessor communication devices! None specified 

unit record devices! LP 

Enter CL/R»;] vector? CSRj printer option 

(iCKMC timeout count <0=no KMOr KMC vector* KMC CSR]> for! 

>* 16. LP controller CD! 200r 177514. LA180j0.300i 1601303 CS3! ,tLP11-B 

Disks! DD» DL 

Enter CL/Rr3 vector. CSR. number of drives for! 
3. DD controller CD! 300.1765003 CS]! ,,2 

>* 3. DL controller CD! 160.1744003 CS3! .,2 

'V* CT r^rs*** A nr^,* A .:- --^ pi /\ ■* / at /\ n> rr. ♦ oiAiT r a -i • fm«« 

.•■* iJ%j * wwiiwi *f ■•'■•Aif v« 4.r> oil r\t-vj./i\b.v£ LJJ« r\i-v.i.j i. ■u jt iNUVii 

>* 53. Contr unit 1. is an RL01/RL02 CD! RL013 CS3! RL02 
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Tapes? None specified 

Non-phBsicsl (pseudo) devices! COj NL» TIj CLj LB> SY 

Terminal interface devices? YLr YZ 

Enter veetorj CSRt E = DL11-E modem sijpport/NO = no for? 

* 21, YL controller CD! 60» 177560i NO: CS]t 

Enter vectorf CSRi highest line number <0 to 7> ti answer speed] for! 

>* 24. YZ controller CTit f.»3003 CS:: 310 , 1 60 100 t 3 . 3C 

y r 

>t EOS * Do aou want to J <CR>-contin!js R-repeat section E-exit P-psus© LSli 

End of interrupt vector area has been set to 400 

Create Executive build files 

>* 1. Do you wish to edit sna of the Executive files? LY/Hli H 

^^ i 

> t 

>* EOS * Do aou want to! <CR>-continue R-repeat section E-exit P-pause CS3! 



Prepare for task buildina 



Clean-up extraneous object files 



;* EOS * Do you want to! <CR>-continue R-repeat section P-pause CS3! 

End of IISGEN phase I at 13!53!06 on 15-MAR-83 
— To continue type! eC200»20031 1SGEN2 

>e <EOF> 



>@113GEN 

> r 

>i RSX-liS Version 4.1 BL35-A System Generation done on RSX-llH 

!.'■■■ r 

>? Copyright (C) 1979t 1981 , 1983 

>t Digital Eouipment Corporationj Maynardf Mass. 

>S All Rights Reserved. 

> i 

>i RL01/RL02 distribution kit 

> r 

>* 3. Do you want to inhibit execution of MCR commands (PREP6EN)? CY/N3! 

>* 4. Have uou made a copu of the distribution kit? CY/N3! Y 

>* 5. Are sou SeneratinS an unmapped system? CY/N3 1 

>* 6. Use an input saved answer file? CY/N3! Y 

>* 7. Name of input saved answer file CD! SYSSAVED.CMD3 CSJ! 

>i Phase I input saved answers 

>i created on 15-MAR-B3 at 13!16:20 

>> by IISGEN version 2.0 

>i are from file DLO! C200f 2001SYSSAVED.CMD; 1 

>i 

>t 9. Name of output saved answer file CD! DLO! C200f 200:SYSSAVED.CMD3 CS]! 

>S 

>T Phase I output saved answers created in file DLO! C200>200aSYSSAVED.CHn>2 

>i 
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>* 10.. Use saved host conf isuration? CY/n:; Y 

>« 11. Use saved periphersl conf isuration? CY/ND! Y 

>* 12. Skip end of section <EOS) breakpoints? CY/Ni: Y 

>* 13. Skip end of execution (EOX) breakpoints? CY/N3t Y 

>* 14. Clean up files from previous GENs? CY/N3! 

>* 16. Enter device for EXCPRV disk when it is reada (ddut) CD? DLlJa CS3: 

>r 

>MOU DLi: EXCPRV 

>PIP /PR 

DLO: has 14667. blocks freei 5813. blocks used out of 20480. 

Largest contiguous space = 9578. blocks 

1400. file headers are freer 136. headers used out of 1536. 

>SET /UIC=C11»10] 

Target conf isuration 

Processor;il/23 Memory SiseS 128K. Mapped S«stem:RSX-llS 

Floatins Point Processor 
Parita Memory 

Host conf isuration 

Executive Options 

Terminal driver options 

System Options 

Thinking . . . 

End of Executive option generation at 13J58M1 on 15-MAR-83 

Peripheral configuration 

Parameters appearing in sausre brackets "C...3' can onlu be 
specifi,ed for the first controller of a particular device. 
Parameters appearing in parentheses '<...)" only need be specified 
if the indicated option is present on the target system. 

The default for loadable drivers has been set tc #TRUE*. 
To override this setting enter R (resident) as the first parameter 
for the first controller of the specified device. 

A/n and Laboratory devices! None specified 

Interprocessor communication devices. None specified 

Unit record devices? LP 

Disks! DD» DL 

Tapes! None specified 

Non-Physical <pseudo) devices! COr NL? TI? CL» LB? SY 

Terminal interface devices! YLt YZ 



>SET /UrC=Cl»243 ! Cresting TTDRVBLD.CMD 

>SET /UIC=C11»103 

>i End of interrupt vector area has been set to 400 

>S 

>; 

>r Create Executive build files 

>i 

>PIP RSXMC.MAC=DH!RSXMCO.MAC/AP 

>INS «MAC 

>ASN sy:=lb! 

>i 

>i Start of Executive assembly at 14I04!55 on 15-MAR-83 
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>SET /UlC=Lllr2Al 

>MAC eDLlJRSXftSM 

>f 

>i End of Executive sssembia at 14J32J15 on 15-HAR-83 



>t Start of device drivers sssemblB at 14J32516 on 15-MAR-83 

!> ? 

>«AC eriLlJRSXDRVASM 

>» 

>; End of Device drivers assembly at 14J49J56 on 15-HAR-83 

> r 

.>ASN =lb: 
>f 

>t Prepare for task buildina 

>i 

>SET /UIC=Clf243 

>PIP RSX11S.0BS=I11.24]*.0BJ 

>PIP TTDRg.0BJ=Ell,243*.TTY 

>INS $LBR 

>LBR RSXIIS/CRJIOO. J1010.:i28.=RSXllS.0BS 

>LBR TTDRU/CR:30. :256. ;64.=TTDRy 

>PIP /NV = i:ilil03RSXBLD,CMD 

>PIP C 1 1 r 1 03RSXBLD . CMD } */DE/NM 

>REM LBR 

>f 

>r Clean-up extraneous object files 

> r 

>PIP RSXllS.OBSr«/liE/NMfTTDRV.OBJf*iCll,243*.OBJ5«,*,TTYJ* 

>REM MAC 

>D«0 DLIJEXCPRV 

DM0 — TTO; dismounted from DLIS 

DMO — TTO: dismounted from DL15 *#* Final dismount initiated «#« 

14;55J58 *** DLi: -- Dismount complete 

> ? 

>• End of 1.3SGEN phase I at J4;55!59 on 15-MAR-83 

>' — To continue type? 5C200j 20031 1S6EN2 

>f 

>SET /UIC=C200»2003 

>(? <EOF> 



>eC200,200311SBEN2 
>i 

>T RSX-llS Version 4.1 BL35-A System Generation Phase II 

>', 

>i Copyright (C> 1975. 1981. 1983 

>> Digital Eauipment Corp.. Maynard. MA. 01754 

>. All Rishts Reserved. 

>{ 

>f Build The Executive And All Reauired Tasks 

>.' 

>i This command file will produce the target system on your SY: disk. 

>; If it is an RK05 or an RLOl. this command file will delete a number 

>5 of files from this disk to make room for those reauired to complete 

>. this 11S6EN. You must be running on an expendable copy of 

>i your disk. Note however, that the disk will be left in a 

>5 state such that RSX-llS sysSens may be performed at a later 

>. date. In addition, the sysSen itself may be terminated and 

>r may be restarted at Just about any point to rebuild particular 

>. Pieces of the system. 

>. 

>* In what UIC is SGNPARM.CMD if not C200.2003 CS3; 

>f RL01/RL02 distribution kit IISGEN version 2,0 for RSX-llM BL35-A 

>5 

>i Continuation from IISGEN PHASE I done on 15-MAR-83 at 14155:48 

>TIM 

15:00:37 15-MAR-83 

>i 
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>i The map device specified roust slresda be mounted with UIC Cli343. 
>i If it is notf respond to the next Question with "Z and do so. 

y i 

>* In which device is the EXCPRV disk CDDU:] CS3J DLl J 
>HOU DLltEXCPRy 

>ASN sy;=lb: 

> 5 

>! Expanded coitiments provide 3 conrplete description of evers step in 

>f this IISGEN command file. On the other hand, short comments 

>i provide virtually no explanatory text. 

>» 

>* Do aou want expanded comments? Z\/Nlt Y 

y f 

>> Make room on the baseline disk to complete the IISGEN 

>^ 

>SET /UIC=C1»13 

>PIP Clj343*.!|t/PU/NM 

>PIP Clf54aCTDRV.TSK;*/DE/NM»DBriRV.TSK{*.DPDRV.TSK5«»DRDRV.TSKJ* 

>PIP C1.54aCTDRy.STB;*/DE/NM.DBDRV.STB;*>DPDRV.STB»*.DRDRV.STBJ* 

>PIP C200j2003SYSGEN2.CMrif«/DE/NM 

>PIP /FR 

DLO! has 14549. blocks free? 5931. blocks used out of 20480. 

LarSest contiguous space = 9578. blocks 

1401. file headers are freej 135. headers used out of 1536. 



Create RSX-llS subset system library 
if you have not already done so. 

>iNS by:*lbr 

>* Have aou already created IISLIB.OLB? CY/N3J 

>lbr lb:iislib/cr;30.:896.:320. 

>REM LBR 

>* Have you already built the Exec? [Y/N3: 

>SET /UIC=C1.243 

>» 

>? Pur3e Exec build command files and assembly prefix files 

y J 

>PIP RSXBLD.CMD/PU/NM 

>PIP Cllf 103RSXMC.MAC/PU/NM 

Now we build the Executive 

If you must make chanses to the Executive build files 
answer yes to the followinS ouestion. Edit RSXBLD.CMD 
by issuing the command EDI LBiRSXBLD.CMD. 11SGEN2 will 
build the Executive after you resume from the pause. 

>* Do you wish to edit the Executive build file? CY/ND! 

>INS sy;*tkb 

>TKB SLBJRSXBLD 

>» Did the Executive build successfully? CY/N3! Y 

> j 

y> You now need the Executive maps to layout 

>f the partitions in your new system. 

y ? 

>* Do you have the maps already? CY/N3 5 

>LOA LP; 

>PIP LP;=DLi:ClT34JRSXllS.MAPrEXC0Ml.MAP>EXC0M2.MAP 

>UNL lp: 

>J Look in the map of the Exec for the symbol •»SYTQP" which 

>f indicates the last address allocated to the Exec. User 

>r partitions may start at ana location beyond this address 

>f as lonS as they fall on a A4 bate boundary. See the RSX-llM 

>5 Sysgen manual for 3 description of how to set up partitions. 

>T You may wish to stop at this time to layout your partitions. 

>5 

>SET /UIC=C1»64D 

>* Do you want to build any loadable drivers now? CY/N3J Y 

Build Loadable drivers 
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>« 3. Device for driver's ni3PS CD! NL ! 3 CS3J 
>SET /UIC=Clf24a 

The following are nineinonics of the loadsble device drivers selected. 

DD DL LP 

When sll drivers are built? strike carriage return. 

>* 5. Driver 2-ch3r3cter device mnemonic CS3J DD 
>* 6. Drive partition name CDS DRUPAR3 CS3: 

>TKB @dli:dddrubld 

>* 5. Driver 2-ch3r3cter device mnemonic CSl* DL 

>* 6. Drive partition nsme CDJ DRWPAR3 CS3: 

>TKB SDLlJDLDRyBLD 

>* 5. Driver 2-ch3r3Cter device mnemonic CS3 5 LP 

>* 6. Drive partition name CDS DRyPAR3 CS3S 

>TKB eDLlSLPDRVBLD 

>* 5. Driver 2-ch3r3cter device mnemonic ES3J 

>SET /UIC=C1»643 

>REM TKB 

>SET /UIC=Clr243 

>PIP RSXllS.OBj;*/nE/NM 

>* Have aou alresda built the full duplex terminal driver? CY/N3S 

Now we build the full duplex terminial driver 

The task build command file for the full duplex terminal drive 
specifies that it run in partition TTPARj having a length of 
40000 octal. 

>* Do sou wish to edit the build command file for the terminal driver? CY/N3$ 

>INS SY!$TKB 

>TKB eLBtTTDRVBLD.CMD 

>* Did the terminal driver build successfully? CY/N3! Y 

>REM TKB 

>* List full duplex terminal driver map? CY/N3S Y 

>LOA LPS 

>prp LPS=DL1SC1»343TTDRV.MAP 

>UNL LPS 

>* Do you want to continue and build the privileged tasks? CY/N3S Y 

:>D«0 DLIS 

DM0 — TTOS dismounted from DLIS *«* Final dismount initiated *«* 

15$15!28 *** DLi; — Disfflount complete 

Prepare to assemble and build the RSX-llS privileged 
software components. 

The tasks TKTN» BASMCR» OTL» and SIP must be assembled? and the 

task build command files possibly edited before they can be built. 

The tasks RSDVOSf RSDV52f and RSDVIH need only to be built, but 

their command files may slso be edited before they sre built. 

It is not necessary to save/print the assembly listings! 

However? we recommend that you save/print the task build 

maps. This is especially important when generating 

an unmapped system -- without maps it will be difficult 

to determine partition limits. 

>* Assembly list device for privileged tasks (DDNNS) CDS NLS3 CS3S 
>* Map device for privileged tssks (DDNNS) CDS SYS3 CS3S 
>* Have you already built task TKTN? CY/N3S 

Task TKTN will be included in your IIS system as a result 
of your selection in 11S6EN Phase I. 

The privileged tasks BASMCR? OTLf and SIP were specially designed 
for use in the R3X-il3 environment. Their inclusion in the system 
is optional. If desired? they will be assembled and built under 
control of this command file. 
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>* Do uou wish to include BASMCRr OTL? or SIP in uour sastem? CY/N3: Y 

!> r 

>F The tasks RSDV05f RSDV52» snd RSDVIH dynsmicslly disp-lsa the 

>? the status of memory on s Srsp-hics terminal and can be built 

>r for the VT05B terminal i VT52 terminal? and VTIOO terminal 

>} respectively. These tasks display which tasks are in memory 

>; and where in memory thea reside? which task is currently 

>r running f and the status of poolt 

> r 

>* Do you want to include RSDUOSj RSDV52r or RSDVIH? CY/N]! Y 

> ? 

>f The RSX-llS subset file control services (FCS) are dist- 

>i ributed as a sinsle file containina the concatenated object 

>i modules. Thea cannot be placed in the RSX-llM system object 

>J library (SYSLIB. OLE) . However? users who reauire this FCS 

>f should link with the RSX-llS subset of SYSLIB <11SLIB.0LB) 

>r created durinS this Sysaen. 

y 9 

>* Do aou wish to include the RSX-llS subset FCS? CY/N3t Y 

y r 

>? If you have previously done an RSX-llS SasSen on this disk? all 

>T of the files were transferred to the UFD C2f203. These were 

>? optionally deleted ba the SysSen process. Therefore? unless 

>? it was specified to delete the files or they were later 

>? deleted independently? there is no need to copy all of the 

>f files from the release kit aSain. 

!^'* ? 

>* Do you have to copy the files from the release kit? CY/NK Y 

>* Enter device and unit of RSX-llS distribution kit (DDNNJ) CS15 DLIJ 

?■ ? 

>? Place the RSX-llS release kit cartridSe disk in drive DLl! 

y r 

y* Is the disk ready in drive DLIJ? CY/NJ! Y 

>SET /UIC=C2?20] 

>INB SYt*UFD 

>UFD SY:C2?203 

>REM UFD 

>PIP *.*?*/DE/NM 

>MOU DLlJllSKITl 

>PIP SY{=DL1: 

>DMO DLi: 

DM0 — TTO: dismounted from DLi: #** Final dismount initiated *** 

15{20:46 «** DLi; -- Dismount complete 

>SET /UIC=C11?103 

>iNS sy;$ufd 

>UFD SY:C11?103 

UFD -- Directory already exists 

>REM UFD 

># Do aou wish to make corrections to RSX-llS source modules? CY/N3! 

>INS SY!$«AC 

>SET /UIC=[l?24a 

>MAC BTKNASM 

>PIP TKNASM.CMD J */D£ 

>REM MAC 

y T 

>? The task build command file for TKTN specifies that it run in 

>? partition SYSPAR? having a lenSth of 3700 octal. 

>? If you must change the partition name or length? 

>? you will have to edit its task build command file. 

>f 

>* Do you have to edit the task build command file for TKTN? ZY/Hlt 

>INS SYJ*TKB 

>TKB eTKNllSBLD.CHD 

>REM TKB 

> r 

yt BASMCR is a Privileged task which supplies a subset (or basic 

>; set) of the RSX-llM MCR commands. It can not be included if 

>? during Sasgen Phase I aOu indicated that aou did not want ana 

>? terminal devices. Its size? depending upon options? ranges 

>? from 6400 to 14000 octal on mapped systems. 
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>* Do you want to include task. BASMCR? CY/N3: Y 
>INS SYJ*UFD 

>UFri SYlciirloa 

>UFD SY5C16r243 

>REM UFD 

>SET /UIC=C16.103 

>PIP BHPRE.HAC»*/DE/NH 

>PIP *.MAC?«/RM/NM 

>PIP C16r*3*.*;*/DE/NM 

>PIP C16»10D=C2»20DB«PRE.MAC 

>PIP C16jlO]/EN=C2f203ABOBAS*MAC.ATLBASjBRKBASiERRBAS>ERRMSG 

>PIP C16jl03/EN=i:2r203FMTDU.MACjFNDUCB.SNBLK,6ETNUMrKEYUD 

>PIP [16f 10J/EN=C2j203LKLST.MftC.«CRBASrOPEBAS.PRSBASfREDBAS 

>PIP i:i6»10]/EN=C2.203REMBAS.«AC»RPSBASfRUNBASrTIMBAS 

>SET /UIC=C16f24: 

>i 

The size of BASIC MCR is dependent upon the inclusion of 
conditional assenblu code. The inclusion of the code is 
controlled bs symbol definitions appearing in an ssseinblu 
prefix file. The default for these conditionals is 
exclusion. The followind options? slon^ with the corres- 
ponding control svtmbolsr are available! 



R$*ATL - ATL/TAL COMMANDS 
R$$ERM - ERROR MESSAGE TEXT 
R»*OPE - OPEN COMMAND 

To include an option locate the desired conditional sunbol 
and remove the semicolon at the besinnins of the line. For 
example; 



*PL fR$»ATL 
fR**ATL = 
*C /?// 
R$*ATL = 
* 



I INCLUDE ATL 
J INCLUDE ATL 



Repeat this for all desired options. Note that the suabols 
sppear on consecutive lines in alphabetical order in the file. 



INCLUDE ATL 



INCLUDE ATL 



>« Do you wish to edit the assembly prefix file for BASMCR? CY/N3: 

>INS sy:$edi 

>EDI C16fl03BHPRE.MAC 
[00029 lines read in] 
CPsae 13 
*PL 5R»$ATL 
jR«$ATL = 

«c /;// 

R*»ATL = 

«PL tR»*ERM 

fR$*ERM = 

«C /»// 

R»«ERM = 

«PL >R»*OPE 

!R*»OPE = 

«C /?// 

R*$OPE = 

«EX 

CExita 



INCLUDE ERROR MESSAGES 



INCLUDE ERROR MESSAGES 



INCLUDE OPEN 



INCLUDE OPEN 



>REM EDI 

>iNS sy;$mac 

>MAC 8BASMCRASM.CMD 

>REM MAC 

>SET /UIC=C1»243 

>PIP Cl&i.l03BMPRE.MACt«/DE/NM 

>PIP C16tl03*.MACF«/RM/NM 

>PIP BASMCR. 0BJ=C16f24]«. OBJ 

>PIP C16»243«.«J«/DE/NM 

>INS SYJ$LBR 

>LBR BASMCR/CR:2i. ;64. :64.=BASMCR 

>REM LBR 

>PIP BASMCR. 0BJf«/DE/NM 
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>} 

>5 The task build command file for BASMCR specifies that it 

>r run in partition MCRPARj length 14000 octal (mapped), 

>F If uou must change the partition name or leni^thr 

>i SOU will have to edit its task build command file. 

>i 

>* Do you wish to edit the task build command file for BASMCR? [Y/N]J 

>iNS sy:*tkb 

>TKB 0BASMCRBLD.CMD 
>REM TKB 

>; 

>» OTL is a privileged task which is the RSX-llS on-line task loader. 

>» It performs the install* load» and fix functions for tasks which 

>t were created on a host development sustem and copied via FLX to a 

>» load medium. Depending on the number of load devices? etc» OTL 

>f panaes from 8000 to 15000 octal on mapped systems. 

'> f 

>« Do aou want to include task OTL? CY/N3! Y 

>iNS sy;*ufd 

>UFD SY:C20fl03 
>UFD SY:C20.243 
>REM UFD 
>SET /UIC=C20»10: 

>pip sy:otlpre.macj*/de/nm 

>PIP SY{*.MACS*/RM/NM 

>PIP C20»«3».«J*/DE/NM 

>PIP C20.103=C2f2030TLPRE.MAC 

>PIP C20.10]/EN=C2.2030TL.MAC»OTLCD»OTLCHfOTLERR 

>PIP C20» 103/EN=C2»203,0TLHD.MAC»0TLLB»0TLLD»0TLQI0»0TLRD 

>SET /UIC=C20.24D 

>! 

The size of OTL is dependent upon the inclusion of conditional 
assembly code. The inclusion of the code is done in two ways* 
bu a single symbol definition and by macro calls appearing 
in an assembly prefix files The first controls the inclusion 
of error message text. To include this oPtion» locate the 
symbol R$$ERMr and remove the semicolon from the beslinnina 
of the line. The default for error message text is exclusion. 
For example! 



«PL fR$»ERM 
»R$»ERM=0 
«C /!// 
R*$ERM=0 

The other type of option concerns the exclusion of unwanted 
device support. For each of the OTL load devices which 
were included in Sys^en Phase It corresponding support will be 
Senerated in OTL. Naturallyr support will not be venerated for 
those OTL load devices which were not included in Sys^en Phase I. 
The following devices along with corresponding control symbols 
may be supported by OTLJ 

PRll - PAPER TAPE READER PR 

RXll - RXll FLEXIBLE DISK DX 

RX21 - RX211 FLEXIBLE DISK DY 

TAll - CASSETTE TAPE CT 

TCll - DECTAPE DT 

TMll - TH/TMA/THBll MAGTAPE MT 

TSll - TS04 MAGTAPE MS 

TU16 - TJ/TWII16-45 MAGTAPE MM 

TU58 - TU58 CARTRIDGE DD 

To exclude OTL support for a device which has been generated into 
your RSX-llS Executive* locate the corresponding device symbol 
and place a semicolon at the beginning of the line. For example! 

«PL PRll 

INCLUD PRll»Pt$Rll fPCll/PRll SUPPORT 
«C //*/ 
f INCLUD PR11?P«$R11 5PC11/PR11 SUPPPRT 
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>r Perforni this for sll of the above devices which will be fart of 

>i Bour RSX-llS Executive? but for which uou do not want OTL 

>f support. Note that the ssabols appear on consecutive lines in 

y m alphsbetical order in the file* 

>i 

>* Do aou wish to edit the assembla prefix file for OTL? CY/N3; Y 

>iNS sy:*edi 

>EDI C20il030TLPRE.MAC 

[00036 lines read inH 

CPaSe 03 

#PL JR$«ERM 

C0003A lines read in] 

iR$*ERM=0 

*C /i// 

R*$ERM=0 

*EX 

CExit] 

>REM EDI 

>iNs sy:*mac 

>MAC @OTLASM,CMD 

>REM MAC 

>SET /UIC=C1»24] 

>PIP C20t1030TLPRE.MAC5«/DE/NM 

>PIP C20»103«.MAC»«/RM/NM 

>PIP 0TL,0BJ=C20f241«.0BJ 

>PIP C20j24a*.*f*/DE/NM 

>iNS sy:*lbr 

>LBR 0TL/CR:21.:128.{64.=0TL 

>LBR 0TL=C2F20aBLXI0M 

>REM LBR 

>PIP OTL.OBJf*/DE/N« 

>r 

>f The task build cDmaand file for OTL specifies that it 

>! run in partition OTLPARj lensith 15000 octal (mapped). 

>i If you must chanse the partition name or len3th» 

>J «ou will have to edit its task build command file. 

>J 

>* Do Bou wish to edit the task build command file for OTL? ZY/Hl', 

>INS SYSSTKB 

>TKB eOTLBLD.CMD 

>REM TKB 

> J 

>! SIP is 3 privileged task which performs the RSX-llS SBstem 

>i ima^e preservation duties. It replaces the RSX-llM SAU MCR 

>i command. Depending on the number of load devices? etcj SIP 

>i ranges from 3700 to 7400 octal on mapped SBStems. 

> > 

>« Do Bou want to include task SIP? CY/N3{ Y 

>INS sy:*ufd 

>UFD SY5C21f10J 
>UFD SYtt:21»243 
>REH UFD 
>SET /UIC=r21rl03 

>pip sy:sippre.mac?*/de/nh 
>pip sy:*.mac;*/rm/nh 

>PIP i:21r*3*.*}*/DE/NM 

>PIP C21,103=C2r203SIPPRE.MAC 

>PIP C21j103/EN=C2>201SIP.MAC»SIPBOOtSIPCD»SIPERR 

>PIP [21»103/EN=C2F203SIPLD,MACrSIPQI0 

>SET /UIC=C21»243 

>J 

>» The size of SIP is dependent upon conditional assembly code 

>f in exactlB the same manner as OTL. There are onlB a few minor 

>r differences. OTL supports the paper tape reader usins the 

>J control symbol PR115 SIP on the other hand supports the paper 

>J tape punch using the control sBOibol PPll. In addition* OTL 

>; supports DECtape II cartridges using control symbol TU58 and 

>J TSll magnetic tare drives usinS the control symbol TSll. 

>! Edit SIPPREsMAG in the same was described for OTL. For example* 
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*PL FPU 



INCLUD PP11fP**P11 



*C //f/ 



INCLUD PPll.PitPU 



fPCll/PRU SUPPORT 
fPCll/PRll SUPPPRT 



>« Do 
>INS S 
>EDI C 
C00036 
CPaSe 
#PL jR 
C00036 
fR$$ER 
*C /?/ 
R*$ERM 
*EX 
CExitJ 



aou wish to edit the sssembla prefix file for SIP? CY/N3; Y 

y;$edi 

21»10aSIPPRE.MAC 

lines read in] 
01 
*$ERM 

lines read in! 
M = 

^0 



>REM 
>INS 
>MAC 
>RE« 
>SET 
>PIP 
>PIP 
>PIP 
>PIP 
:>INS 
;LBR 
:-REM 
;-PlP 

=■? Th 

>! r u 

>r If 

>r yo 



Era 

SYJ 
@SI 
MAC 
/UI 
C21 
C21 
SIP 
C21 
SYJ 
SIP 
LBR 
SIP 



*MAC 
PASH . CMD 

C=Clr241 
Tl01SIPPRE.MAC»*/riE/NM 

j10]*.mac;*/rm/nh 

.0BJ=C21»24a«.0BJ 

i243*.*!*/riE/N« 

*LBR 

/CR;20. !64.S64,=SIP 

OBJJ*/DE/NM 



e task build comihand file for SIP specifies that it 
n in Partition SIPPARr length 7400 octal (mapped). 

uou must change the partition name or lensthr 
u will have to edit its task build command file. 



>* Do 90U 

>INS sy;$ 
>TKB esip 
:-REM TKB 
>SET /UIC 
>PIP RMD. 
>* Do you 
;■* Do you 
■* Do you 
■■ ? 

■5 The t 
>r run in 
•f If sou 
>r Will h 



wish to edit the task build command file for SIP? CY/N3! 
TKB 
BLD.CHD 

Cl»24] 
0LB/NV=C2»203RMDHAP.OLB 
want to include task RSDV05? CY/Ni: 
want to include task RSDV52? CY/NJI 
want to include task RSDVIH? tr/Hll Y 



sk build command file for RSBVIH specifies that it 
partition RSDVIH? length 40000 (octal), 
must change the partition name or lenath» hou 

avG to edit the task build command file. 



>* Do wou wish to edit the task build command file for RSDMIH? CY/NJ: 

>INS 8Y:*TKB 

>TKB gRSDVlHBLD.CMD 

TKB — *DIftG«-Syii.bol HEADER not found for patch 



>REH TKB 

> r 

>? Add subset PCS to the RSX-llS system object library 

.■■■ r 

>SET /lJIC=tl,lD 

>INS sy:*lbr 

>LBR LBtllSLIB/RP=t2»20]FCSllS 

:>REM LBR 

>pip lb;iislib.olb/pu/nm 

>SET /UIC=C1»64] 

>PIP *.«/PU/NM 

>P1P Clf243«.*/PU/NM 
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The operation left to be performed is that of the final 
conf iaurstion of the virsSin executive usina Virtual MCR. 



unii 1.1 = 



•,+ in r^r.r,fi<s,,Ta +h<a Fvor a+ thic + i mo iicincf UMR"? rY/NI' Y 



The contents of your RSX-llS release kit currently resides 
under the UFD |;2j203. If aour SYJ disk is not an RK06/07 or an 
RP04/05/06 aou may want to delete these files. Leaving 
them on the disk will save the time of re-copuins them the next 
time you perform an RSX-llS SysSen, If your SYJ disk is an RK05f 
they will be automatically deleted. 

>* Do you want to delete the RSX-llS kit from this disk? [Y/N3: 

Ue will now make a copy of your target system 



>f 



IP RSXllS.SYS/Ny/CO/BL J498.=RSX11S.TSK 

If you wish to make a copy of aour task or system ima^e file 
on another device we will pause now to allow aou to do so. 

* Do you wish to copy your system to another device? ZY/H2t 

RSXllS.TSK is 3 backup copy of the IIS system aou have Just built. 
If you do not wish to retain itf we will delete it now. 

>* Do aou wish to delete the system backup file RSXllS.TSK? CY/NJJ 

Your target system is now ready to set up partitions and install 
the reouired tasks. The procedure to follow isJ 

1) Run Virtual MCR 

2) Extend POOL space to base of first partition 

3) Set UP your partitions 
3B) Load needed drivers 
3C) Set UP a partition for the Directive Common 

4) Install tasks (BASMCRt OTLj SIPj TKTN) 

5) Fix tasks into (virtual) memory 

6) Optionally set the time and save a copy of THE 
sastea on a bootable aediuiii 

7) Exit from virtual MCR and boot in your target system 

VMR example: 

>VMR ! RUN VIRTUAL MCR 

ENTER FILENAME:RSX11S.SYS ! VMR PROMPTS FOR FILE NAME 

vmr>set /pool=xxx ! extend pool to first partition base 

/main=ttpar:xxx:xxx:task iset up full duplex tt partition 
/main=drvpar!xxxjxxxttask ! set up driver partition 
/mftin=excomi:xxx;xxxjcom ! set 1st exec. common 
excoml ! install 1st executive common 



VMR>SET 

VMR>SET 

VMR>SET 

VMR>INS 

VMR>SET 

VMR>INS 

VMR>SET 

VMR>SET 

VMR>SET 

VMR>SET 

VMR>SET 

VMR>SET 

VMR>SET 

yMR>LOA 

VMR>INS/FIX 

VMR> INS/FIX 

yMR>INS/FIX 

VMR>INS/FIX 

•VMR>INS/FIX 

VMR>TIM 10:45 11/10/7? 

VMR>SAV DXJRSXllS 

VMR>"Z 



/main=exc0m2:xxx:xxx:c0m 
exc0m2 ! install 
/main=syspar;xxx:xxx:task 

/MAIN=MCRPAR!XXX!XXX:TASK 

/main=0tlpartxxx:xxx!ta3k 
/main=sippar;xxx:xxx:task 
/main=rsdvih;xxx:xxx{ 

/MftIN=GENSXXX{XXX5SYS 

/main=gen:xxx:xxx 



XX! 



tkn 

basmcr 
otl 
sip 

R3DV1H 



ASK 
! IF 
TASK ! IF 
LOAD XXDRV 
INSTALL S FIX 
INSTALL 
INSTALL 
INSTALL 
INSTALL 
SET TIME 



! SET 2ND EXEC. COMMON 
2ND EXECUTIVE COMMON 

SET UP TKTN PARTITION 
SET UP MCR PARTITION 
SET UP OTL PARTITION 
SET UP SIP PARTITION 
ISET UP RSDVIH PAR 
SYSTEM CONTROLLED PAR. 
USER CONTROLLED PARTITION 



FIX 
FIX 
FIX 
FIX 
AND 



TKTN 
BASIC 
OTL 
SIP 

RSDVIH 
DATE 



MCR 



SAVE 
EXIT 



SYSTEM ON RXOl FLOPPY 
FROM VIRTUAL MCR 
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End of VHR ewample 



Now we will run Virtual MCR so that uou may initialize 
aour system. Be sure to define all reauired partitions 
at this timer because the SET function is not sup-ported 
in RSX-llS BASIC MCR. Furthermoref if you plan to 
include BASIC MCR and OTL in your systentj they must 
be installed and fixed into memory. Other tasksr 
such 3s SIP and TKTN may be loaded into a running 
RSX-llS system usin5 OTL. 

note: Since LOAD and UNLOAD are not supported on 
s running RSX-llS systemr all reauired loadable 
drivers must be loaded usina VMR. 

NDTE5 You have reouested to include the 

directive common. You must install the 

common prior to exittina Virtual MCR 

or your RSX-llS system will not boot. 
>INS SYSJVMR 
>VMR 

Enter filename.* RSXllS 
UMR>BET /POOL=* 

yMR>SET /main=ttpar:*moo:task 

VMR>LOA TT: 

VMR — «DIAe*-Lo3dable driver larger than 4K 

UMR>SET /main=drvpar:«:#5sys 

VMR>LOA DD: 

yMR>LOA DLJ 

VMR>LGA LP J 

yMR>SET /TOP=DRVPAR!-* 

VMR -- #DIAG*-Inst3lled tasks may no longer fit in partition 

gMR>SET /main=excohi;*;20o;com 

UMR>INS EXCOMl 

MMR — *DIAG*-Partition reduced to executive common size 

VHR>SET /MAIN=EXC0M2;«:200:C0M 

VMR>INS EXC0M2 

VMR — *DI AG*-p3rtition reduced to executive common size 

UMR>SET /main=syspar:*;ioi:task 
yMR>SET /main=mcrparj*:i37:task 
vmr>set /main=0tlpart#!150:task 
vmr>set /main=sippar:«!74:task 
vmr>set /main=rsdvih{«:40o;task 

yMR>SET /MAIN=6EN:«!*JSYS 
VMRMNS TKN/FIX = YES 
yMR>INS BASMCR/FIX=YES 
VMR>INB 0TL/FIX=YES 
VMR>INS SIP/FIX=YES 
VMR>INS RSriVlH/FIX = YES 
VMR>REA RSDVIH 1 TTl : 
VMR>REA RSnVlH 2 TTl J 
VMR>TIM 16:29 15-HAR-83 
UMR>SAU Dri:iis 
yMR>"7 

>5 

>» When this command file completesj your RSX-llS system is 

>i ready to run, 

>REM VMR 

>SET /UIC=C200»2003 

>TIM 

1AJ23:00 15-«ftR-83 

>i 

>0 <EOF> 
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TESTING MEMORY 
0128. KW 
START? DD 

xdt; 35-A 

XriT>6 

RSXUS V4.1 BL35-A 



TIM 
16J30;i6 15-MAR-83 
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3.5 SYSGEN ON A RSX-llM-PLUS HOST SYSTEM 

This section contains information on preparing for your RSX-llS SYSGEN 
on an RSX-llM-PLUS host. 

For the most part, the actual dialogue and procedures for the RSX-llS 
SYSGEN are the same as those for an RSX-llM host. The procedure for 
performing an RSX-llS SYSGEN on an RSX-llM-PLUS host is the same as is 
currently documented. The only differences are in the numbering and 
wording of some of the questions. These changes are reflected in the 
RSX-llS SYSGEN on a RSX-llM host. 



3.6 SYSGEN ON A VAX/VMS HOST SYSTEM 

This section contains information on preparing for your RSX-llS SYSGEN 
on a VAXAMS host. 

For the most part, the actual dialogue and procedure for performing an 
RSX-llS SYSGEN on a VAX/VMS host is the same as is currently 
documented. The only difference is in the numbering and wording of 
some of the questions. These changes are reflected in the RSX-llS 
SYSGEN on a RSX-llM host. 

Also, if you have disk quota checking on your SYS$LOGIN device (your 
work disk) , it must be disabled before you begin your RSX-llS system 
generation. This is because the compatibility mode task, MAC, needs 
to create temporary work files in UICs that probably do not have an 
established disk quota on SYS$LOGIN. Otherwise, MAC cannot assemble 
any files during IISGEN. 

To disable disk quota checking, invoke the Disk Quota Utility 
(DISKQUOTA) by issuing the following command line: 

$ RUN SYS$SYSTEM:DISKQUOTA 

When the DISKQUOTA prompt appears on your terminal, issue the 
following command lines: 

DISKQ>USE diskname: (RB) 

DISKQ>DISABLE!Sg) 

DISKQ>eenz) 

$ 

where diskname: is the name of the SYS$LOGIN device. 

Now disk quota checking is disabled and you are ready to begin your 
RSX-llS SYSGEN. 



3-24 



RSX-llM/RMS-11/RSX-llS 
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READER'S COMMENTS 

NOTE: This form is for document comments only. DIGITAL will use comments submitted on this form at the 
company's discretion. If you require a written reply and are eligible to receive one under Software 
Performance Report (SPR) service, submit your comments on an SPR form. 



Did you find this manual understandable, usable, and well organized? Please make suggestions for improvement. 
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